Full text of "tektronix :: 800x :: 070-3441-00 8002A Edi Jan80"

See other formats

Ttektronix

COMMUTED TO EXCELLENCE

This product is compatible with: TEKDOS VERSION 3.X

8002A

//PROCESSOR LAB

EDITOR

Version 3.X

Tektronix, Inc.

P.O. Box 500

Beaverton, Oregon 97077

Serial Number

070-3441-00

Firo Pnntinn .IAN 19R0

WARRANTY

Tektronix warrants that this product, excluding customer-supplied
equipment, is free from defects in materials and workmanship. The
warranty period is ninety (90) days from the date of shipment.
Tektronix will, at its option, repair or replace the product if Tektronix
determines it is defective within the warranty period. CRTs are
warranted for one (1) year. During the nine (9) months following
expiration of the product warranty, Tektronix will replace defective
CRTs at no charge for the material.

In the forty-eight (48) contiguous United States, the District of
Columbia, and in other areas where Tektronix normally offers on-
site service for this product, Tektronix will provide this service at no
charge during the product warranty period described above. In
areas where Tektronix does not offer on-site service for this product,
warranty service will be provided at no charge if the product is
returned, freight prepaid, to a service center designated by
Tektronix.

Tektronix may use the original vendor's service organization to
service any product that is supplied but not manufactured by
Tektronix.

Tektronix is not obligated to furnish service under this warranty-.

a. to repair damage resulting from attempts by personnel other
than Tektronix representatives to install, repair, or service the
product;

b. to repair damage resulting from improper use or from
connecting the product to incompatible equipment;

c. if personnel other than Tektronix representatives modify the
hardware or software.

There is no implied warranty of fitnesss for a particular purpose.
Tektronix is not liable for consequential damages.

Copyright © 1980 Tektronix, Inc. All rights reserved.
Contents of this publication may not be reproduced in any
form without the written permission of Tektronix, Inc.

Products of Tektronix, Inc. and its subsidiaries are
covered by U.S. and foreign patents and/or pending
patents.

TEKTRONIX, TEK, SCOPE-MOBILE, and tB are reg-
istered trademarks of Tektronix, Inc. TELEQUIPMENT is
a registered trademark of Tektronix U.K. Limited.

Printed in U.S.A. Specification and price change
privileges are reserved.

8002A Editor Version 3.X

TABLE OF CONTENTS

Page
Section 1 LEARNING GUIDE

Introduction 1-1

Editor Overview 1-2

IIIOIUUIII^ LI IO ITICVV UUILUI I -fc +

Demonstration Run 1-7

For Continued Learning 1-14

Section 2 PROCEDURES

Introduction 2-1

The Essentials 2-2

Displaying Text 2-8

Line Manipulation 2-1 1

Character String Manipulation 2-15

Block Manipulation 2-19

Command Shortcuts 2-25

Section 3 COMMAND DICTIONARY

Introduction 3-1

Dictionary Page Format 3-1

Terminology 3-1

The Workspace Buffer 3-2

Command Lines 3-3

Special Keys 3-4

Editor Commands 3-6

Section 4 TECHNICAL NOTES

Note 1 — Comparison of EDIT 3.X with Previous Versions 4-1

Section 5 ERROR MESSAGES
Section 6 GLOSSARY
Section 7 INDEX

8002A Editor Version 3.X

Section 1
LEARNING GUIDE

Page
Introduction 1-1

Editor Overview 1-2

Uses of the Editor 1-2

General Features 1-3

The Workspace 1-3

Installing the New Editor 1-4

Equipment Needed 1-4

Installation Procedure 1-4

Demonstration Run 1-7

Create a Text File 1-7

How to Correct Input Mistakes 1 -7

Set Tabs 1-8

Enter Text 1-8

Display Text 1-9

Save Text on the Disc 1-9

Modify a Disc File 1-10

Get Disc File Text into the Workspace 1-10

Move the Workspace Pointer 1-11

Substitute Text 1-11

Display Editor Line Numbers 1-12

Move a Block of Text 1-12

Find and Change a Character String 1-12

Enter Multiple Commands on a Line 1-13

Print a Copy on the Line Printer 1-13

For Continued Learning 1-14

(a <|_j

8002A Editor Version 3.X

Section 1
LEARNING GUIDE

This Learning Guide provides a general overview of the new TEKDOS Editor version 3.X,
shows you how to install the editor on your system, and offers you a simple demonstration
for hands-on experience. When you are finished with this Learning Guide, you should be
able to do simple editing and be ready to learn more about the editor by reading other
sections of the manual.

This Learning Guide is divided into the following topics:

• Editor Overview. An explanation of the editor and its general features.

• Installation Instructions. Step-by-step instructions for installing the new editor on your
TEKDOS system disc.

• Demonstration Run. How to invoke the editor, enter text, save the text in a file, and
reedit an old file.

• For Continued Learning. A guide to using other parts of this manual to learn more
about the editor.

1-1

Editor Overview

Learning Guide— 8002A Editor Version 3.X

EDITOR OVERVIEW

Uses of the Editor

The text editor is an important programming tool. It is useful whenever text must be created
or modified. You can use the editor to enter and debug source programs, to prepare
command files and data files, and to create documents. Figure 1-1 is a diagram of typical
work flow, showing suitable editor tasks.

document

proposed

program

write
program

create
source
file

prepare
data for
program

compile/
assemble
program

execute
program

document

working

program

correct

program

bugs

* Indicates a task
suitable for the
text editor

3441-2

Fig. 1-1. The role of the editor in programming..

The editor is used to create and modify source programs, data files, and documentation. TEKDOS
command files and editor command files may also be created with the editor.

1-2

Learning Guide— 8002A Editor Version 3.X Editor Overview

General Features

The TEKDOS Editor V3.X is line-oriented: most editor commands operate on a single line of
text. The editor accepts a command line, executes it, and prompts for another command line.
Because the editor is not screen-oriented, it can be used on hard-copy terminals as well as
on CRTs.

Here are some of the features of the TEKDOS Editor V3.X:

• Text iines can be entered from the keyboard or brought in from disc files.

• Tab stops can be used to align columns of text.

• Text may be stored on disc with tab characters unexpanded.

• Text may contain control characters.

• Strings of characters can be found and modified.

• Blocks of text can be moved or repeated within the file.

• A text line can be referenced either by its number or by its position relative to the
workspace pointer. Text can be displayed with or without line numbers.

• A command sequence can be repeated a specified number of times, or until a command
within the sequence fails.

• Frequently used command sequences can be stored in command files or command
macros and executed as they are needed.

• Entire editing sessions can be performed by command files without operator
intervention.

• Files that exceed the size of the editor workspace can be edited conveniently in
sections.

• The editor workspace may occupy up to 55K bytes of memory.

• Error messages tell not only what went wrong, but which command or parameter
caused the error.

• Several editor features can be turned on or off to suit the needs of the current editing
session.

The Workspace

The TEKDOS Editor program uses 9l3pytes of 8002A memory. The remaing program memory is available
for the workspace buffer. When the 8002A contains four memory modules (64K bytes), 55Kbytes are
available for the workspace. This translates to about 1400 lines of text averaging 40 characters each. With
two modules (32K bytes) of memory, 23JCbytes are available for the workspace. The text being edited is
stored in the workspace. A pointer in the workspace designates one of the lines of text in the workspace as
the current line. Most of the editor commands execute relative to that workspace pointer. If there is no
text in the workspace, the workspace pointer points to the end-of-text marker.

REV A JUN 1980 1-3

Installing the New Editor Learning Guide— 8002A Editor Version 3.X

INSTALLING THE NEW EDITOR

The new TEKDOS Editor V3.X program is on the editor installation disc. To use the new
editor, you must transfer it to the TEKDOS system disc, where it replaces the obsolete editor
program.

Equipment Needed

• 8002 A u Processor Lab

• TEKDOS system disc

• Editor installation disc

• Two blank discs that have been formatted and verified with the TEKDOS commands
FORMAT and VERIFY. For details about these commands, refer to the Command
Dictionary section of the 8002A System Users Manual.

If this editor installation procedure is terminated for any reason before the
procedure is finished, the software on the discs may be destroyed. Make
copies of both the TEKDOS system disc and the editor installation disc before
you attempt to install the new editor. Use the two blank discs for this
purpose.

Installation Procedure

This procedure uses the following conventions:

• Underlined text in the examples indicates what you enter from the terminal.

• Text not underlined is the system response displayed on the terminal.

• The symbol <CR> indicates a carriage return that you enter from the terminal.

1 . Make a Backup Copy of Your TEKDOS System Disc. Load your system disc into
drive 0. When the TEKDOS prompt {>) appears, load one of the blank formatted discs
into drive 1 . Then enter the following TEKDOS command line:

> PUP 1<CR>

TEKDOS takes approximately 15 to 25 minutes to duplicate your system disc onto the blank
disc. When the prompt (>) appears, remove the original system disc from drive 0. By using
the duplicate disc, your valuable system disc is protected from harm. Remove the duplicate
system disc from drive 1 and insert it into drive 0. All further references in this section to the
"system disc" will refer to the copy you have just made.

1-4

Learning Guide— 8002A Editor Version 3.X Installing the New Editor

9 IV/lakp a Raoklin C^f\n\t r»f tho FHitrir Inctallatirtn njer» Thie cnaniol r\rr\r*arit ira muct

be followed carefully so that the new system disc will not be harmed. Make sure that

ro w aim niOi unvc I IS duply. L.IHCI IMC I Ul IUVV 1 1 iCj

command line:

> DUP<CR>
*DTTFf~ETnTOR 09
*DUP* EOJ

TEKDOS indicates an error at this point because no drive numbers were specified.
However, software essential to the rest of this procedure was copied from the system disc
into the 8002A system memory. Ignore the error, and remove the system disc from drive
0. Load the editor installation disc into drive 0, and the remaining blank formatted disc
into drive 1. Then enter the following command line:

> DUP 1<CR>

TEKDOS takes approximately 2 minutes to copy the editor installation disc. When the
prompt appears, remove the original editor installation disc from drive and store it for
backup. All further references in this procedure to the "editor installation disc" will refer
to the copy you have just made.

3. Install the New Editor on the System Disc. Load the new TEKDOS system disc into
drive 0, and enter the following command line:

> INSTALL/KCR>

The INSTALL command file takes approximately 30 minutes to transfer the new editor to
the system disc. The following messages will appear on the terminal as the job
progresses:

* PLEASE DO NOT INTERRUPT THE INSTALLATION AS IT MAY DESTROY
YOUR DISC.

* HAVE YOU BACKED UP YOUR SYSTEM DISC ??
FILL 0000, 4000, 00- 3ffF, 0QCO

FETCH TEKD0S/0

PATCH 3956 C0C0C0"J>2.

PATCH 3QBD C0C0C0 "3<*B>ft SHCOCOCO

MODULE TEKD0S/0, 80, 3FFF, 100

•MODULE* EOJ

REPLACE EDITOR/1, /0, 27, /1

Member 01 copied from System Overlay File.

Member 02 copied from System Overlay File.

♦REPLACE* EOJ

COPY /1 , /0

*C0PY* EOJ

WLb /I

£ A*DELETE* EOJ

* DONE, PLEASE REBOOT THE SYSTEM
INSTALL/1 COMPLETED

1-5

Installing the New Editor Learning Guide— 8002A Editor Version 3.X

Reboot the 8002A. The SYSTEM RESTART switch is located on the right side of the
8002A front panel. Flip this switch upward. In a few seconds the terminal will display
the TEKDOS greeting ( a bell, the software version identifier, and the prompt). You may
now use the EDIT command to invoke the new editor (or you may use any other
TEKDOS command).

If your system does not restart properly, you may have a faulty disc or an installation
problem. Consult your 8001 /8002A Installation Guide or your service representative for
possible solutions.

1-6 @

Learning Guide— 8002A Editor Version 3,X Demonstration Run

DEMONSTRATION RUN

In this demonstration run, you use the editor to create and modify a file named TIGERS.

Create a Text File

To invoke the editor and create the new file, enter the following command:

TEKDOS invokes the editor, creates a new file named TIGERS on the system disc, and sends
the following message to the terminal:

** EDIT VER 3.0
** NEW FILE
*

If the message ** NEW FILE does not appear, the file TIGERS already exists on the disc. If
you want to keep the existing TIGERS file, enter the editor command QUIT to exit the editor
without harming the file. Then reinvoke the editor, using a new file name. If the file TIGERS
already exists and you continue with this example, the previous contents of TIGERS will be
lost.

The editor prompt character is the single asterisk (*). The asterisk prompt indicate that the
editor is ready to accept an editor command.

How to Correct Input Mistakes

Before you begin to input text, you need to know how to correct your mistakes on the input
line. You may correct only the line you are currently entering. Once you have entered a
carriage return to end the line, no other corrections may be made to that line while the editor
is in input mode.

To Correct Characters One-By-One:.

• The BACKSPACE key on a refresh CRT terminal cancels the current character in the
input buffer, erases it from the screen, and moves the cursor one space to the left. This
may be repeated as many times as necessary.

• The DELETE key on a hard copy terminal cancels the current character in the input
buffer and prints the deleted character. This may be repeated as many times as
necessary.

• The RUBOUT key cancels the current character in the workspace and either moves the
cursor one space to the left (default setting) or echoes the character on the screen,
depending on the setting of the editor command CRT. This may be repeated as many
times as necessary.

1-7

Demonstration Run Learning Guide— 8002A Editor Version 3.X

To Replace an Entire Line:.

• Press the escape (ESC) key once to delete the line. Then reenter the line from the
beginning.

NOTE

If you accidentally press the escape key twice in succession, the editor will be
suspended and control will return to TEKDOS. To notify you that this has
occurred, a double TEKDOS prompt (») will be displayed on the terminal. To
return to the editor enter the TEKDOS command CONT *. You may then
continue the editing session from the point where the double escape was
entered.

To intentionally suspend the editor, please use the SUSPEND command
rather than the escape key.

Set Tabs

For this example you use special tab settings to list items within your text. The editor has
default tab settings in columns 8, 16, 24, 32, 40, 48, 56, and 64. For this example, the tabs
are reset to columns 4, 8, and 20 before you enter the text. (The special tab settings are not
saved between edit sessions, so you may want to enter a remark line in your text to remind
you of their location.) The default tab character is control-l (sent by the tab key). Because
control-l is not a printing character, it is difficult to edit if the need arises. This example
shows how to use a substitute tab character that does print. The tab character may be any
character you choose. However, be sure it is not a character you are using in the text. In this
example the percent sign (%) is used. After the text is entered with percent signs for tab
characters, the tab character definition will be changed from control-l to the percent sign to
show how the tab characters are expanded to spaces. Enter the following command:

*TABSJ48 20<CR>
*

Enter Text

You are now ready to enter your text. The new file contains no lines as yet. Since the
workspace is empty, the workspace pointer is located at the end-of-text marker. The text that
you enter will be inserted before the workspace pointer. Multiple lines of text are entered in
input mode.

The editor command INPUT is used for entering text. There is no prompt character in input
mode. Enter each new line immediately after the carriage return that terminates the previous
line. A carriage return on an empty line terminates input mode.

1-8 (5)

Learning Guide— 8002A Editor Version 3.X Demonstration Run

Enter the following text (your entries underlined):

*INPUT<CR>

INPUT*

WHY EVERY FAMILY SHOULD OWN A TIGER: <CR>

%1.*PR0TECTI0NXA FAMILY WITH A TIGER NEED NEVER<CR>

WWORRY ABOUT BURGLARS. SALESMEN, OR<CR>

^NEIGHBORHOOD DOGS.<CR>

%27%AFFECTION%A WELL-TRAINED TIGER IS VERY AFFECTIONATE<CR>

%%%T0 THE OWNER'S FAMILY. <CR>

%3- %ADMIRATION%A TIGER IS THE ULTIMATE STATUS SYMBOL. <CR>

UNINSPIRING AWE AND ADMIRATION IN EVERYONE .<CR>

<CR>

When you enter the carriage return on the empty line, the editor exits from input mode and
displays the asterisk prompt, indicating that you may enter the next editor command.

Display Text

After entering your text, you'll want to view it to see if it is correct. The editor command TYPE
is used to display text. The TYPE command, without parameters, displays the current line
only. To display all of the lines in the workspace, enter TYPE B-E. "B" stands for the
beginning of the text in the workspace, while "E" stands for the end. Before you enter the
TYPE command, change the tab character so you can view the expanded text.

* TABl<CR>
*

The TAB % command causes all percent signs in the text to be expanded to spaces to line up
the text in the previously defined tab columns.

* TYPE B-E<CR>

WHY EVERY FAMILY SHOULD OWN A TIGER:

1. PROTECTION A FAMILY WITH A TIGER NEED NEVER

WORRY ABOUT BURGLARS, SALESMEN, OR
NEIGHBORHOOD DOGS.

2. AFFECTION A WELL-TRAINED TIGER IS VERY AFFECTIONATE

TO THE OWNER 'S FAMILY.

3. ADMIRATION A TIGER IS THE ULTIMATE STATUS SYMBOL,

INSPIRING AWE AND ADMIRATION IN EVERYONE.

Save the Text on the Disc

Since the text you've displayed looks correct, go ahead and store it on the disc under the file
name TIGERS which you specified when you invoked the editor. The editor command FILE
saves the contents of the workspace in the disc file and exits from the editor.

* FILE<CR>

** END OF TEXT
*D0S* EOJ

Tho ** PWn OP TPYT mpccanp ehr\i«ic thqt all thia tout i«<a<- «»n-;-f+/-»r-> fr«m +K/i >»Arl/ C r-.o~«-> *r* +U«

■ i nj i_i it^ VI I l_/\ I I I iCxjuyC JMVIId LIIUl Ull UlC ll/Al VVQO VVI ILLCI 1 IIUIII II IC VVUI l\Opai/C l\J 11 IC

file. The *DOS* EOJ message tells you that the editor mode has been terminated (End Of
Job). The > prompt character tells you that TEKDOS is ready for the next TEKDOS command.

1-9

Demonstration Run Learning Guide— 8002A Editor Version 3.X

Modify a Disc File

Let's alter the text you have just created. (The text could have been changed before you
stored it, but we'll begin a new editing session to illustrate certain editor commands.) Invoke
the editor with the EDIT command:

>EDIT TIGERS<CR>

** EDIT VER 3.0 «•
«

Notice that the ** NEW FILE message does not appear here, since the file named TIGERS
already exists. Although you've invoked the editor, the contents of the file TIGERS is not yet
in the workspace. You can verify this by entering the TYPE command:

*TYPE B-E<CR>

** END OF TEXT
*

This shows that the workspace pointer is pointing to the end-of-text marker; there are no
lines of text in the workspace.

Get Disc File Text into the Workspace

The editor command GET is used to transfer text from the disc file to the workspace. The GET
command, without parameters, gets only the next line of the disc file. To transfer all the
lines, enter the GET command with a parameter equal to or greater than the number of lines
in the file. (In this case, 20 is large enough.)

*GET 20<CR>
** EOF

The message ** EOF shows that the all of the text in the file TIGERS has been copied into the
workspace. The text has been placed before the current line in the workspace. You can use
the TYPE command to make sure the text is in the workspace.

*TYPE B-E<CR>

WHY EVERY FAMILY SHOULD OWN A TIGER:

%1 . ^PROTECTIONS FAMILY WITH A TIGER NEED NEVER

%%%W0RRY ABOUT BURGLARS, SALESMEN, OR

^NEIGHBORHOOD DOGS.

%2.5&AFFECTION%A WELL-TRAINED TIGER IS VERY AFFECTIONATE

%%%T0 THE OWNER'S FAMILY.

S3.%ADMIRATION5&A TIGER IS THE ULTIMATE STATUS SYMBOL,

UNINSPIRING AWE AND ADMIRATION IN EVERYONE.

1-10 @

Learning Guide— 8002A Editor Version 3.X Demonstration Run

The text looks like it did when we entered it. If we want to see it in tab expansion form, the
previous tab settings must be entered.

* TAB%<CR>

*TABS H 8 20<CR>

*TYFE — B-E <Cft>

WHY EVERY FAMILY SHOULD OWN A TIGER:

1. PROTECTION A FAMILY WITH A TIGER NEED NEVER

WORRY ABOUT BURGLARS, SALESMEN, OR
NEIGHBORHOOD DOGS. _

2. AFFECTION A WELL-TRAINED TIGER IS VERY Afr'fr fcCTlONA'it

TO THE OWNER'S FAMILY.

3. ADMIRATION A TIGER IS THE ULTIMATE STATUS SYMBOL,

INSPIRING AWE AND ADMIRATION IN EVERYONE.
*

Move the Workspace Pointer

The position of the workspace pointer affects many of the editor commands. Searches are
carried out from the workspace pointer to the end of the text. Any changes are made in the
text of the current line, pointed to by the workspace pointer. Text is printed, displayed, or
moved with reference to the workspace pointer.

The first place we'll change the text is in the first line. If every family owned a tiger, it would
not be a status symbol. Therefore, lets change "every family" to "you". Move the workspace
pointer to the first line of text with the BEGIN command:

*BE GIN<CR>

WHY EVERY FAMILY SHOULD OWN A TIGER

When the workspace pointer is moved, the new line that it points to is displayed.

Substitute Text

The editor command for substituting text is SUBSTITUTE. The command is followed by a
delimiter (a character not found in either text string), the text to be replaced, a delimiter, the
replacement text, and a delimiter. (All three delimiters must be the same character.)

* SUBSTITUTE /EVERY FAMILY/YOU/<CR>

WHY YOU SHOULD OWN A TIGER

The resulting text is displayed. The workspace pointer remains on the same line.

@ 1-11

Demonstration Run

Learning Guide— 8002A Editor Version 3.X

Display Editor Line Numbers

Many of the editor commands refer to line numbers; thus, it can be very useful to know the
number of each line. The editor command NUMBER ON causes line numbers to be displayed
along with the text.

•NUMBER ON<CR>
« TYPE B-E<CTT ~

1: WHY YOU SHOULD OWN
1. PROTECTION

2. AFFECTION

ADMIRATION

A TIGER:

A FAMILY WITH A TIGER NEED NEVER

WORRY ABOUT BURGLARS, SALESMEN, OR

NEIGHBORHOOD DOGS.

A WELL-TRAINED TIGER IS VERY AFFECTIONATE

TO THE OWNER'S FAMILY.

A TIGER IS THE ULTIMATE STATUS SYMBOL,

INSPIRING AWE AND ADMIRATION IN EVERYONE.

Move a Block of Text

What if the block of text referring to protection would be better as the last item in the list? To
move those three lines, use the editor command MOVE. This command includes two
parameters: the range of lines to be moved, and the line before which the moved lines are to
be placed. The section to be moved includes lines 2 through 4; the line before which they go
is line 9 (the end of text).

*MOVE 2-4 9<CR>
** EOF

Now use the TYPE command to display the result:

•TYPE B-E<CR>

WHY YOU SHOULD OWN A TIGER:

2. AFFECTION A WELL-TRAINED TIGER IS VERY AFFECTIONATE

TO THE OWNER'S FAMILY.

3. ADMIRATION A TIGER IS THE ULTIMATE STATUS SYMBOL,

INSPIRING AWE AND ADMIRATION IN EVERYONE.
1. PROTECTION A FAMILY WITH A TIGER NEED NEVER

WORRY ABOUT BURGLARS, SALESMEN, OR
NEIGHBORHOOD DOGS.

Find and Change a Character String

Now that you've moved the block of text, the paragraph numbers are in the wrong order. To
correct the paragraph numbers, use the FSUBSTITUTE command, which finds and replaces a
string of text. The command is followed by a delimiter (a character not found in either text
string), the text to be searched for and replaced, a delimiter, the replacement string, and a
delimiter. (All three delimiters must be the same character.) Before you enter the
FSUBSTITUTE command, first enter the BEGIN command. This starts the search at the first
line of the text. The period following BEGIN tells the editor not to display the line, as it
normally would. Many commands that display the resulting line may be followed by a period
if you do not want the line displayed.

"BEGIN. <CR>
" FSTJBimTUTE /1/3/<CR>

51 -j: PROTECTION A FAMILY WITH A TIGER NEED NEVER

1-12

Learning Guide— 8002A Editor Version 3.X

Demonstration Run

Pnfpr IWInl+inlo PftmrpanHc r\n Hno I irto

To change each of the remaining two numbers, enter the BEGIN command and the
FSUBSTiTUTE command on one iine. When you enter more than one command on a line, the
commands must be separated by a colon (:). Most of the editor commands may be entered in
short forms instead of the long forms we have been using so far. This example shows the
use of the short forms of the commands. The short form of BEGIN is B ,the short form of
FSUBSTITUTE is FS, and the short form of TYPE is T.

*B.

/2/1

*T B-E<CR>

T AT5MIRATI0N A TIGER IS THE ULTIMATE STATUS SYMBOL,
/<CR>

t: atfection A WELL-TRAINED tiger is very affectionate

"WHY YOU SHOULD OWN A TIGER:

1. AFFECTION A WELL-TRAINED TIGER IS VERY AFFECTIONATE

TO THE OWNER'S FAMILY.

2. ADMIRATION A TIGER IS THE ULTIMATE STATUS SYMBOL,

INSPIRING AWE AND ADMIRATION IN EVERYONE.

3. PROTECTION A FAMILY WITH A TIGER NEED NEVER

WORRY ABOUT BURGLARS, SALESMEN, OR
NEIGHBORHOOD DOGS.

Print a Copy on the Line Printer

The text is now in the form you want. You may want to get a permanent copy, using a line
printer or other hard copy peripheral attached to the system. To do this, you use the LIST
command. The LIST command is much the same as the TYPE command. The line printer or
other hard copy unit must, of course, be connected to the 8002A and be ready to receive the
output.

*LIST B-E<CR>

No output is sent to the terminal. Only the prompt is displayed to show that the editor is
ready for another command.

Now use the FILE command to save the changed text on the disc file and exit the editor. The
changed text will replace the old text in the file.

» FILE<CR>

** END OF TEXT

** EOF
*DOS* EOJ

1-13

For Continued Learning Learning Guide— 8002A Editor Version 3.X

FOR CONTINUED LEARNING

In this Learning Guide we explained some elementary editor concepts. For a more detailed
explanation, refer to the following sections of this manual:

• Section 2, Procedures. Describes a series of tasks and the commands needed to
perform those tasks. All of the tasks include examples as well as instructions.

• Section 3, Command Dictionary. Provides a formal description of each editor
command, its operation, and its syntax. Most command descriptions have illustrative
examples. Commands are arranged alphabetically. TheTEKDOS command EDIT is also
described in detail.

• Section 4, Technical Notes. Describes the differences between the old and new
versions of the editor.

• Section 5, Error Messages. Gives a thorough explanation of error messages what to do
about them.

1-14 @

8002A Editor Version 3.X

Section 2

j^ p~ ^^ ^^ ^ jH^ g g gs^ fB ^J^

rRuucuuRw

Page
Introduction 2-1

The Essentials 2-2

Invoking the Editor 2-2

Exiting the Editor 2-3

Creating a File 2-4

Modifying an Existing File 2-5

Resetting the Tab Stops 2-6

Expanding Tab Characters to Spaces 2-6

Displaying Text 2-8

Displaying Text from the Workspace 2-8

Displaying Text from a File 2-8

Displaying Line Numbers with the Text 2-9

Listing a File with Line Numbers 2-10

Line Manipulation 2-11

Moving the Workspace Pointer 2-1 1

Controlling the Current-Line Display 2-12

Moving Text within the Workspace 2-13

Repeating a Block of Text 2-14

Character String Manipulation 2-15

Finding a String 2-15

Replacing a String 2-16

Making a Global String Replacement 2-17

Block Manipulation 2-19

Editing a Large File by Sections 2-19

Moving Text Forward in the File 2-20

Rearranging Text from One or More Files 2-21

Saving Text on a File 2-22

Adding Text from a File 2-23

Command Shortcuts 2-25

Entering Several Commands on a Line 2-25

Repeating a Command Sequence 2-25

Creating and Using a Command Macro 2-26

Executing Commands from a Command File 2-27

(a 2-i

8002A Editor Version 3.X

Section 2
PROCEDURES

Section 1, the Learning Guide, gave you a general overview of the TEKDOS Editor (Version
3.X) and presented a simple demonstration run. This section presents some common
procedures for using the editor with your 8002A //Processor Lab.

Each procedure in this section is presented in the following format:

Description: A summary of the action(s) performed by the procedure.

Procedure:

Parameters:
Comments:
Examples:
See also:

The information entered or displayed at the system terminal. The
following conventions are used in the procedure description:

Underlined: A character sequence you enter.

No underline: A character sequence displayed by the editor or by
TEKDOS.

UPPERCASE: An exact character sequence; if these characters are
underlined, enter them exactly as shown.

lowercase: A parameter you supply when you perform the procedure.

A description of the values you supply.

The operating limits and options for the procedure.

One or more demonstrations of correct entry format.

Cross-references to related procedures.

2-1

The Essentials

Procedures— 8002A Editor Version 3,X

THE ESSENTIALS

Invoking the Editor

Description:

Procedure:

Parameters:

Comments:

Examples:

This procedure invokes the editor and specifies the file to be created or
edited.

> EDIT file

file — The disc file to be created or edited.

The full form of the EDIT command is described in the Command
Dictionary section of this manual. The short form

EDIT file

is sufficient for routine applications.

If the specified file does not exist, it is created. If the file already exists, it
is modified and the old version is saved under a backup name.

> EDIT SUBS

If SUBS already exists, it becomes the primary input file and a temporary
primary output file is created. When you close the editing session with a
FILE command, the edited contents of SUBS are copied to the primary
output file. The primary output file is renamed SUBS and the primary
input file is renamed SUBS*.

If SUBS did not previously exist, there is no primary input file. The text
written to the primary output file must come from the keyboard or from
alternate input files. When a FILE command closes the editing session,
the primary output file is saved under the name SUBS.

See also:

Exiting the Editor
Creating a File
Modifying an Existing File

2-2

Procedures— 8002A Editor Version 3.X The Essentials

Exiting the Editor

Description: There are three ways to return control from the editor to TEKDOS:

• The FILE command copies the contents of the workspace and
the remainder of the primary input file to the primary output file,
saves the primary output file, and terminates the editor.

• The QUIT command terminates the editor without further action.
The primary output file is lost unless it existed before the editor
was invoked.

• The SUSPEND command causes a temporary exit to TEKDOS. To
return to the editor, enter CONT *; to terminate the editor as
with a QUIT command, enter ABORT *.

Procedure: * FILE

* QUIT

"SUSPEND

> CONT *

" SUSPEND

> ABORT *

See also:

• Modifying an Existing File

• Resetting the Tab Stops

• Expanding Tab Characters to Spaces

2-4

Procedures— 8002A Editor Version 3.X

The Essentials

Modifying an Existina File

np^rrintinrv

Procedure:

ThiQ nrnffirii irp rpnl^rpc a fiio rroatoH nroi/im ioiw ikw tha a/-iit/-«r /->r

otherwise) with an edited version.

> EDIT filename

** EDIT VERSION 3-0
*NEXT

TT-^oF
* Make the necessary changes in the file.
•FILE

""TND OF TEXT

** EOF
*D0S* EOJ

Parameters:
Comments:

filename — The name of the file to be modified.

The file is modified according to the editor commands you enter. The old
version is given a backup file name.

The NEXT command brings the contents of the file into the workspace,
moves the workspace pointer to the first line, and displays that line.

Examples:

> EDIT SHORTY

** EDIT VERSION 3.0
•NEXT

** EOF
THIS IS LINE ONE OF SHORTY.
• SUBSTITUTE/SHO/THE NEW SHO/
THIS IS LINE ONE OF THE NEW SHORTY.
•FILE

TND OF TEXT

** EOF
*D0S* EOJ

Disc file SHORTY is modified. The new version of the file is named
SHORTY and the old version is named SHORTY*.

See also:

• Creating a File

• Editing a Large File by Sections

2-5

The Essentials

Procedures— 8002A Editor Version 3.X

Resetting the Tab Stops

Description:
Procedure:
Parameters:
Comments:

Examples:

This procedure sets the tab stops to the columns you want.

» TABS n1 n2 n3 n4 n5 n6 n7 n8

n1 .. n8— The column numbers of the tab stops.

When you invoke the editor, the eight tab stops are at columns 8, 16,
24, 32, 40, 48, 56, and 64. You may specify up to eight new tab stops;
all existing tab stops are lost. The column numbers must be in
ascending order and in the range 1 to 127. Any text you display is
aligned to the latest set of tab stops.

« TABS 10 20 35

This command deletes the existing tab stops and sets new tab stops at
columns 10, 20, and 35.

See also:

• Creating a File

• Expanding Tab Characters to Spaces

Expanding Tab Characters to Spaces

Description:

Procedure:

When you use tab stops in creating a file, the tab characters you enter
remain in the text. This procedure expands each tab character in the file
into the appropriate number of spaces.

> EDIT filename

** EDIT VERSION 3-0
» TAB t

» TABS nl n2 n3 nU n5 n6 n7 n8
* XTABS ON
*FILE

•• END OF TEXT
** EOF

*D0S* E0J

Parameters: filename — The name of the file containing tab characters.

t — The tab character you used in creating the file. If you used the
standard tab character (CTRL-I), omit the TAB command.

n1 .. n8 — The tab stops to which the text is to be aligned. If you want to
use the standard tab stops (columns 8, 16, 24, 32, 40, 48, 56, and 64),
omit the TABS command.

2-6

Procedures— 8002A Editor Version 3.X The Essentials

Comments: The command XTABS ON tells the editor that any tab character copied

from the workspace is to be replaced by spaces up to the next tab stop.
The FILE command copies the text from the primary input file., through
the workspace, to the primary output file. Each tab character is replaced
by spaces as it is copied to the primary output file. Afterward, the
primary output file becomes the new version of filename and the
primary input file becomes the backup version, filenam*.

NOTE

The standard tab character is an acceptable delimiter in MDL and ASM source files, but
may produce unexpected results in other types of files. A file containing non-standard tab
characters (defined with the TAB command} is usually useless.

Examples: > COPY TIGERS

WHY YOU SHOULD OWN A TIGER:

X1.XAFFECTI0NJA WELL-TRAINED TIGER IS VERY AFFECTIONATE

%%%1Q THE OWNER'S FAMILY.

*C0PY* EOJ

> EDIT TIGERS

** EDIT VERSION 3-0
» TAB %

» TABS 4 8 20
« XTABS ON
* FILE

** END OF TEXT

** EOF
*D0S* EOJ

> COPY TIGERS

WHY YOU SHOULD OWN A TIGER:

1. AFFECTION A WELL-TRAINED TIGER IS VERY AFFECTIONATE
TO THE OWNER'S FAMILY.
*COPY* EOJ

See also:

Displaying Text from a File
Displaying Line Numbers with the Text

Displaying Text from a File

Description:

Procedure:

This procedure displays the contents of a disc file without affecting the
text in the workspace.

" COPY lines file C0N0

"COPY lines file LPT1

Parameters:

Comments:

lines — The range or number of lines to be displayed.

file — The name of the disc file to be displayed.

CONO specifies the system terminal; LPT1 specifies the line printer.

d-tt

Procedures— 8002A Editor Version 3.X

Displaying Text

Fvamnlpt; -

*rriPY mi_i?n myrttf rnwn

Thic ^ommanH cisirtc nuor tho -firot 1 f"V\ iirvoc- nf fi/IVCM C onri /-iior-»iowo fho
i i ■ iv^ w *-•• !-»_■ ^i\i|^^ v^wv^i ni^> inoi. ■ w inioo vi ivi i i ii_ i_ cii iu uiopiuyo nio

next 20 lines on the system terminal.

* C0PY 999 HERFILE LPT1

This command displays the first 999 lines of HERFILE on the line printer.
If HERFiLE contains fewer than 999 lines, the entire file is listed.

See also:

Displaying Text from the Workspace
Listing a File with Line Numbers

Displaying Line Numbers with the Text

Description:

This procedure causes each text line displayed by the editor to be
accompanied by its line number.

Procedure:
Comments:

• NUMBER ON

To suppress the display of line numbers, enter the command NUMBER
OFF.

Examples:

•TYPE 3

TTTTO3MY

FRIDAY

SATURDAY

•NUMBER ON: TYPE 3

5: THURSDAY

6: FRIDAY
7: SATURDAY

• BEGIN

IT SUNDAY

• NUMBER OFF: DOWN

MONDAY

See also:

Listing a File with Line Numbers

2-9

Displaying Text

Procedures— 8002A Editor Version 3 X

Listing a File with Line Numbers

Description:

Procedure:

This procedure lists the contents of a file on the line printer. A line
number is printed next to each line so that a command such as COPY or
GET may refer to the proper lines.

> EDIT file

** EDIT VERSION
•NUMBERON

3.0

» NEXT 1000

» LIST B-E
*QUIT

*D0S* EOJ

Repeat these two lines as necessary
to list the entire file.

Parameters: file — The file to be listed.

Comments: Each NEXT command brings the next 1000 lines from the file into the

workspace. The LIST command lists those lines on the line printer,
numbering them 1 to 1 000. Note that lines 1 , 1 001 , 2001 , etc. of the file
are all labeled line 1. When the last line from the file is in the
workspace, the editor responds ** EOF. After the entire file has been
listed, end the editing session with a QUIT command so that the primary
output file (which you do not need) is deleted.

See also:

• Displaying Line Numbers with the Text

2-10

Procedures— 8002A Editor Version 3.X

Line Manipulation

LINE MANIPULATION

Moving the Workspace Pointer

Description:

Procedure:

The editor provides several commands for moving the workspace
pointer.

BEGIN moves the pointer to the first line of text. END moves the pointer
past the last line. UP and DOWN move the pointer up and down the text,
respectively.

FIND and FNEXT move the pointer to the next line containing a specified
string of characters. To find the string, FIND searches only the text in
the workspace. FNEXT searches the workspace, then the rest of the
primary input file, until the string is found.

*BEGIN

*END
or

» UP n
or
•DOWN n

Parameters:

See also:

• FIND/string/

» FNEXT/string/

n — The number of lines up or down the pointer is to move. If this
parameter is omitted, the pointer moves one line.

/—The string delimiter: any character (except a space) not occurring in
the string.

string— The string of characters to be found.
• Finding a String

(5)

2-11

Line Manipulation Procedures— 8002A Editor Version 3.X

Controlling the Current-Line Display

Description: Each of the following commands displays the current line after

executing successfully:

BEGIN END FNEXT NEXT SUBSTITUTE

DOWN FIND FSUBSTITUTE REPLACE UP

This current-line display is controlled by the BRIEF flag.

Procedure: » BRIEF ON

or
"BRIEF OFF

Comments: When the BRIEF flag is at its default setting (OFF), the current line is

displayed whenever any of the above commands is executed. After you
enter BRIEF ON, those commands will not automatically display the
current line.

You may enter a period immediately after any of the above commands to
reverse the BRIEF flag for that command.

Examples: * BEGIN

LINE D*NE The new current line, line 1, is displayed.

» DOWN 3

LINE FOUR

• DOWN. 3

The period suppresses display of line 7.

•BRIEF ON

« "BTGTN

Line 1 is not displayed because the BRIEF flag is ON.
• DOWN 3

Line 4 is not displayed because the BRIEF flag is ON.
• DOWN. 3

LINE SEVEN The period reverses the BRIEF flag temporarily.

•BRIEF OFF

*FP

LINE SIX
• UP.

The period suppresses display of line 5.

2-12 ra

Procedures— 8002A Editor Version 3.X

Line Manipulation

Moving Text within the Workspace

De>srrmtinrr

Procedure:

This nrocedure deletes a section of text from the works n ace and inserts
it elsewhere in the workspace.

*MOVE lines n

Parameters: lines — The number or range of lines to be moved.

n — The moved text is inserted in front of line n. If n is omitted, the text is
moved to the end of the workspace.

Examples: *NUMBER ON:BEGIN. :TYPE 12

JANUARY

FEBRUARY

MARCH

APRIL

MAY

JUNE

JULY

AUGUST

SEPTEMBER

OCTOBER

NOVEMBER

DECEMBER

*M0VE

6-8 2

*TYP£

JANUARY

JUNE

JULY

AUGUST

FEBRUARY

MARCH

APRIL

MAY

SEPTEMBER

OCTOBER

NOVEMBER

DECEMBER

See also:

The MOVE command moves lines 6 through 8 in front of line 2. Lines
are renumbered accordingly.

• Moving Text Forward in the File

• Rearranging Text from One or More Files

2-13

Line Manipulation

Procedures— 8002A Editor Version 3.X

Repeating a Block of Text

Description:

This procedure inserts copies of a selected section of workspace text at
specified points in the workspace.

Procedure:

* SAVE lines

* BEGIN

* FIND/string1/:UNSAVE

* FIND/strinR2/:UNSAVE

*FIND/stringN/ : UNSAVE

Parameters:

Comments:

lines — The number of lines or range of lines to be duplicated. The lines
are inserted in front of each destination line.

stringN— A unique string in the Nth destination line.

/ — The string delimiter: any character (except a space) not occurring in
the string.

Each FIND-UNSAVE command line moves the workspace pointer to a
new destination line and inserts a copy of the selected text in front of it.

Examples:

The following command sequence inserts a line of dashes in front of
every line in the workspace that contains the assembler directive ORG.
(The line of dashes begins with a semicolon because it is an assembler
comment line.)

"INSERT:

• UP.

« SAVE 1

• KILL

• BEGIN.

»*<FIND/ ORG /; UNSAVE: DOWN. >

See also:

The INSERT-UP-SAVE command sequence creates a line of dashes and
copies the line to the save area. KILL deletes the saved line from the
workspace. BEGIN moves the workspace pointer to line 1. The FIND-
UNSAVE-DOWN command sequence finds the next line containing the
word ORG and inserts the line of dashes in front of that line. The repeat
brackets around the FIND-UNSAVE-DOWN sequence indicate that the
sequence is to be repeated until the FIND command fails.

Note that if the text contains tab characters, the search string should be
/tORGt/, not / ORG /. (The "t" represents whatever tab character is in
the text.)

• Finding a String

2-14

(a)

Procedures— 8002A Editor Version 3.X

Character String Manipulation

CHARACTER STRING MANIPULATION

liming a wiiiny

Description:

The commands FIND and FNEXT each move the workspace pointer to
the next line containing a specified string.

If the string does not occur in the workspace at or after the current line,
the FIND command responds NOT FOUND, but the FNEXT command
keeps searching. FNEXT appends the workspace contents to the primary
output file, loads up the workspace from the primary input file, and
searches the new contents of the workspace. FNEXT stops when the
section of text containing the string is in the workspace, or when the
primary input file has been searched to its end.

Procedure:

• FIND/string/

•FNEXT/string/

Parameters: /—The string delimiter: any character (except a space) not occurring in

the string.

string— The string of characters to be found.

Examples:

•NUMBER ON
•BEG IN. :TY PE 2

1:AARDVARK, ADAM

2:AC0RN, ALICE
• FIND/BUFF/

80:BUFFALO, WALTER
•BEGIN. :FNEXT/BUFF/
80:BUFFAL0, WALTER

The string "BUFF" occurs in the workspace, so it is found either by FIND
or by FNEXT.

• FIND/BRU/

** NOt FOUND
• FNEXT/BRU/

43:SPRUCE, BRUCE

The string "BRU" does not occur in the workspace after line 80, so
FNEXT searches the primary input file, section by section. The string is
finally found in line 43 of some later section.

• Moving the Workspace Pointer

<5>

2-15

Character String Manipulation

Procedures— 8002A Editor Version 3 X

Replacing a String

Description:

The commands SUBSTITUTE and FSUBSTITUTE each find a string of
characters in the text and replace that string with a new string. Each
command searches for the string beginning at the current line and
replaces only the first occurrence of the string.

If the string does not occur in the current line, SUBSTITUTE responds
NOT FOUND, but FSUBSTITUTE keeps searching to the end of the
workspace. If the string is found, the line that contains it becomes (or
remains) the current line, the new string replaces the old string, and the
modified line is displayed.

Procedure:

*SUBSTITUTE/ old string/newst ring/

* FSUBSTITUTE/ old string/newstr ing/

Parameters:

/ — The string delimiter: any character (except a space) not occurring in
either string.

Comments:

Examples:

oldstring — The string to be replaced.
newstring — The string that replaces oldstring.

SUBSTITUTE and FSUBSTITUTE may be abbreviated S and FS,
respectively.

» TYPE U

THE CURENT LINE

THE NEXTL INE

THE AFTER THAT

THE LASTEST LINE

» S/R/RR/

THE CURRENT LINE

•FS/TL /T L/

THE NEXT LINE

» S/AFTER/ONE AFTER/

•• NOT FOUND
» FS/ AFTER/ONE AFTER/
THE ONE AFTER THAT
•FS/EST//
THE LAST LINE
»UP.3:TYPE 4
THE CURRENT LINE
THE NEXT LINE
THE ONE AFTER THAT
THE LAST LINE

See also:

Finding a String

Making a Global String Replacement

2-16

(5)

Procedures— 8002A Editor Version 3.X

Character String Manipulation

iviciixiiivj a viiuuai uiimvj iicpiabciuciii

ucai/i ipnui i.

Procedure:

i his procedure replaces every occurrence of a specified string of

characters with a new string.

* BEGIN
* *<FS/oldstring/newstring/>

* BEGIN

* *<FS/ old string/ news tring/> \ Repeat these two lines

*NEXT

as necessary.

Parameters: /—The string delimiter: any character (except a space) not occurring in

either string.

oldstring — The string to be replaced.

newstring — The string that replaces oldstring.

Comments:

The first form of the procedure replaces all occurrences of oldstring in
the workspace. The second form replaces all occurrences in the
workspace and in the text from the remainder of the primary input file.

The FSUBSTITUTE command (short form FS) repeats until it fails to find
a match. Each time a replacement is made, the modified line is
displayed.

When there are no more occurrences of oldstring in the workspace, the
message NOT FOUND is displayed. If you want to continue the global
replacement past the current workspace contents, enter the NEXT
command to bring the next section of text from the primary input file
into the workspace. Then enter the FS command line again.

2-17

Character String Manipulation Procedures— 8002A Editor Version 3 X

Either form of this procedure can be very destructive if you choose your search and
replacement strings carelessly. Note the following points:

• A search string that is too general may lead to unexpected replacements.

• A capital letter never matches a lowercase letter, and vice versa.

• The replacement string should not contain the search string. For example, the
command line

5<FS/MAN/W0MAN/>

replaces the first occurrence of "MAN" with "WOWOWOWOWOMAN".

Examples: *TYPE B-E

A PROGRAM

THIS RAM AND THAT RAM
A PARAMETER
4K RAM

THE LOS ANGELES RAMS
' BEGIN
AHPTTuTIRAM
» »<FS/RAM/rom/>
A PROGrom

THIS rom AND THAT RAM
THIS rom AND THAT rom
A PAromETER
4K rom

THE LOS ANGELES romS
•■ NOT FOUND

Every occurrence of "RAM" in the workspace is replaced by "rom".
BEGIN moves the workspace pointer to the line 1 and displays that line.
The FS command repeats until all occurrences of "RAM" in the
workspace have been replaced. The modified line is displayed after each
FS command.

See also:

• Modifying an Existing File

• Listing a File with Line Numbers

REV A JUN 1980

2-19

Block Manipulation

Procedures— 8002A Editor Version 3 X

Moving Text Forward in the File

Description:

This procedure deletes a section of text from the workspace and inserts
it later in the file being edited.

Procedure:

* SAVE lines
* KILL lines
* FNEXT/destinat ion- string/

The editor searches for the destination line.
The editor displays the destination line.

*UNSAVE

Parameters:

lines — The number of lines or range of lines to be moved.

destination-string— A unique string in the destination line. The text
being moved is inserted in front of the destination line.

/ — The string delimiter: any character (except a space) not occurring in
the string.

Comments.

This procedure is used to move text forward to that portion of the file
that has not yet been brought into the workspace. Use the procedure
"Rearranging Text from One or More Files" to move text backward in a
large file. If the workspace contains both the text being moved and the
destination line, use the MOVE command instead of either of these
procedures.

The SAVE command copies the text being moved into the save area, and
the KILL command deletes that text from the workspace. The FNEXT
command searches for the destination line, first in the workspace, then
in the rest of the primary input file. When the destination line is found, it
is displayed as the new current line. The UNSAVE command inserts the
text being moved into the workspace in front of the destination line.

2-20

(S)

Procedures— 8002A Editor Version 3.X Block Manipulation

Fvgmnjgc; jp thjg QX8rn n !0 thS hflSS Of th6 file 9 r° nnmhomrl fr*r r>jnrjtw Mr-ioc

1001-1050 are moved forward in the file to line 4000.

• TYPE 3
LINE 1001
LINE 1002
LINE 1003
• SAVE 50
» KILL 50
• FNEXT/4000/

** END OF TEXT

** WORKSPACE FULL
LINE 4000
•UNSAVE

The SAVE command copies lines 1001-1050 into the save area, and the
KILL command deletes those lines from the workspace. The FNEXT
command appends the workspace contents to the primary output file,
then brings the next block of text from the primary input file into the
workspace. That block contains line 4000. The editor moves the
workspace pointer to line 4000 and displays that line. The UNSAVE
command inserts the contents of the save area (lines 1001-1050) in
front of line 4000.

See also:

• Listing a File with Line Numbers

• Moving Text within the Workspace

• Moving Text Forward in the File

• Saving Text on a File

• Adding Text from a File

Saving Text on a File

Description: This procedure copies text from the workspace to a disc file.

Procedure: * PUT lines filename

*PUTK lines filename

2-22

Procedures— 8002A Editor Version 3.X

Block Manipulation

Comments:

Examples:

iinoe Th rv'mber or ran^e of lines to be copied !f x/ ou omit this

parameter, only the current line is copied.

filename — The name of the file to which the text is copied. If the file
does not exist, it will be created. If the file already exists, its previous
contents are replaced by the copied text. If you omit this parameter, the
text is appended to the primary output file.

PUT does not affect the workspace contents or pointer. PUTK deletes the
copied text from the workspace; if the current line is deleted, the first
line after the deleted text becomes the current line.

You may also use the commands FILE, FNEXT, or NEXT to copy text from
the workspace to the primary output file.

*PUTK B-E

This command appends the workspace contents to the primary output
file and clears the workspace.

*PUT 40-73 TEMP

See also:

This command saves workspace lines 40 through 73 on disc file TEMP.
Any previous contents of TEMP are lost.

• Adding Text from a File

• Rearranging Text from One or More Files

Adding Text from a File

Description:

This procedure inserts text from a file into the workspace in front of the
current line.

Procedure:

*GET lines filename

Parameters:

Comments:

lines — The number or range of lines to be copied. If you omit this
parameter, only one line is copied.

filename— The file from which the text is copied. If you omit this
parameter, text is copied from the primary input file.

You may also use the commands FNEXT or NEXT to bring text into the
workspace from the primary input file.

2-23

Block Manipulation Procedures— 8002A Editor Version 3 X

Examples: « GET 100

This command brings the next 100 lines from the primary input file into
the workspace.

« GET 100 TEMP

This command brings the first 100 lines from disc file TEMP into the
workspace.

« GET 201-300

This command skips over the first 200 lines of the primary input file and
brings the next 100 lines into the workspace. Afterward, the primary
input file pointer is at line 301.

See also: • Listing a File with Line Numbers

• Saving Text on a File

• Rearranging Text from One or More Files

2-24 (5)

Procedures— 8002 A Editor Version 3 X

Command Shortcuts

COMMAND SHORTCU1

Entering Several Commands on a Line

Description:

This procedure strings together several commands on a single command
line.

Drr\rQrli iro*

Parameters:
Comments:

9k r> r\

/A * <n r\vr\ m nw/^ • s^ r\mrr\ *^v\ /A

viuiiidiiu • \-» win in

emu • v- wiutii auu

command — Any editor command.

A command line may contain any number of editor commands as long
as the command line does not exceed 127 characters. The commands
must be separated by colons (:). If the editor finds an error, ail
subsequent commands in the line are ignored.

Each of the following commands must be the last command on any
command line on which it occurs.

COMMENT FILE PERFORM QUIT SUSPEND

Examples:

*BEGIN. :FIND/ERR0R/:UP

See also:

This command displays the first line containing the string "ERROR",
then moves the workspace pointer to the preceding line and displays
that line.

• Repeating a Command Sequence

• Creating and Using a Command Macro

Repeating a Command Sequence

Description: This procedure allows you to execute a sequence of commands a

specified number of times without reentering the command sequence.

Procedure: *n<command-sequence>

2-25

Command Shortcuts

Procedures— 8002A Editor Version 3.X

Parameters:

command -sequence — A sequence of editor commands separated by
colons (:).

n — The number of times the command sequence is to be executed. If n
is an asterisk (*), the command sequence repeats until a string search
command (FIND, FNEXT, FSUBSTITUTE, or SUBSTITUTE) in the
sequence fails to find a match, or until you press the ESC (escape) key.

Comments:

Examples:

A repeated command sequence may be nested within another repeated
sequence.

» 10<LIST B-E>

This command line lists the workspace contents on the line printer 10
times.

» »<FIND/BYTE/:DOWN.>

This command line displays every line containing the string "BYTE" on
the system terminal.

See also:

• Creating and Using a Command Macro

Creating and Using a Command Macro

Description:

Procedure:

This procedure stores a frequently-used command line (called a macro)
and assigns it an identification number. That command line is executed
whenever its identification number is specified in a MACRO command.

To create a macro:

*MACR0 n=command-line

To execute that macro:

' MACRO n

To list all currently defined macros:
•MACRO

Parameters:

command-line — A sequence of editor commands separated by colons (:

n — The macro identification number: any integer in the range 1 to 127.

2-26

(5)

Procedures— 8002A Editor Version 3 X

Command Shortcuts

Examples:

*MACR010=BEGIN. :TYPE 6: END: UP. 3: TYPE 3

THESE

ARE

THE

FIRST

SIX

LINES

** r- it r* otr TrVT

* " c»u ur ibAi

THESE ARE
THE LAST
THREE LINES

Macro number 10 is defined as a command line to list the first six lines
and the last three lines in the workspace. Those lines are listed
whenever macro number 10 is invoked. MACRO may be abbreviated M.

See also:

• Entering Several Commands on a Line

• Repeating a Command Sequence

Executing Commands from a Command File

Description:

Procedure:

This procedure causes the editor to execute commands from a file
instead of from the system terminal.

*PERF0RM comfile

> EDIT infile outfile comfile

Parameters:

comfile — The name of the editor command file.
infile — The name of the primary input file.
outfile — The name of the primary output file.

2-27

Command Shortcuts Procedures— 8002A Editor Version 3 X

Comments: The editor command PERFORM causes the editor to begin executing

commands from the specified file. When the end of the file is reached or
an error is detected, the editor prompts for a command from the system
terminal.

The initial command file (specified by the third parameter of the EDIT
command) is automatically executed at the beginning of the editing
session.

You may use the editor to create a command file in the same way you
create any other text file.

Examples: The following editing session creates a command file called

TOUCHDOW. TOUCHDOW moves the first line containing the string
"FOOTBALL" to the end of the workspace.

> EDIT TOUCHDOW

** EDIT VERSION 3-0

** NEW FILE
» INPUT
INPUT:

COMMENT — HIKE!
BEGIN. :FIND/F00TBALL/
MOVE 1 E
COMMENT -- YAY!
<CR>
•FILE

** END OF TEXT
•DOS* EOJ

TOUCHDOW may be executed in any subsequent editing session. For
example:

•TYPE B-E

END ZONE

THE FOOTBALL

LINEBACKER

SAFETY

END ZONE

•PERFORM TOUCHDOW

•COMMENT — HIKE!

•BEGIN. :FIND/F00TBALL/

THE FOOTBALL

•MOVE 1 E

•COMMENT — YAY!

•TYPE B-E

END ZONE

LINEBACKER

SAFETY

END ZONE

THE FOOTBALL

2-28 (a

Procedures— 8002A Editor Version 3.X Command Shortcuts

Assume that disc file STARTUP contains the following text:

COMMENT -- Command file STARTUP

COMMENT — This command file begins a standard editing session

COMMENT — for I. M. De Programmer .

COMMENT — Set selected editor flags:

BRIEF ON:ECHO OFF:NUMBER ONrXSEARCH ON:XTABS ON

COMMENT — Select the tab stops and the editor tab character:

TABS 3 5 7 9 11 13 15 60

TAB §

COMMENT — Define standard macros:

COMMENT — Macro 1 displays the first 5 lines and last 5

COMMENT — lines in the workspace.

MACRO 1 = BEGIN. :TYPE 5: END: UP. 5 : TYPE 5

COMMENT — Macro 2 displays the workspace map.

MACRO 2 = DEBUG ON: DEBUG OFF

COMMENT — Macro 3 displays the editor status, the workspace

COMMENT — map, and all currently defined macros.

MACRO 3 = STATUS:MACRO 2:MACR0
COMMENT — End of STARTUP.

The following command begins an editing session that creates or
modifies a file called PROG:

> EDIT PROG, , STARTUP

The commands in STARTUP are executed, then the editor prompts for a
command from the system terminal. At that point, the desired editor
features have been turned ON or OFF, the tab stops and tab character
have been selected, and three macros have been defined.

(5) 2-29

8002A Editor Version 3.X

Section 3

^^ ^\ li/fl Ril A fV I ^k
VsV/IVIIVI#-%IVLJ

fMATIAM A QW

COMMAND INDEX

Page

Pointer Movement Commands

BEGIN — Moves the pointer to the first line in the

workspace 3-7

DOWN — Moves the pointer toward the end of the

workspace 3-17

END — Moves the pointer to the end of the

workspace 3-24

UP — Moves the pointer toward the beginning of the

workspace 3-68

Character String Editing Commands

FIND — Searches the workspace for a string 3-27

FNEXT — Searches the primary input file for a string 3-29

FSUBSTITUTE— Finds and replaces a string 3-32

SUBSTITUTE — Replaces a string in the current line 3-58

XSEARCH— Controls the wildcard search feature 3-72

Line Editing Commands

INPUT— Inputs text from the system terminal 3-36

INSERT — Inserts a line of text from the system

terminal 3-38

KILL — Deletes lines of text from the workspace 3-39

MOVE — Moves lines of text within the workspace 3-44

REPLACE— Replaces the current line 3-54

SAVE — Saves lines of text in the save area 3-55

UNSAVE — Retrieves the text in the save area 3-67

File Manipulation Commands

COPY — Copies text from a file or device to a file

or device 3-1 1

EDIT— Invokes the editor 3-19

FILE — Closes the editing session 3-26

GET — Copies text from a file into the workspace 3-34

NEXT — Brings the next section of text into the

workspace 3-45

PUT — Copies text from the workspace to a file or

device 3-51

PUTK — Moves text from the workspace to a file or

device 3-52

XTABS— Controls expansion of tab characters on

output 3-74

Display Commands

BRIEF — Controls display of the current line 3-8

COMMENT — Precedes a comment in a command

file 3-10

ECHO — Controls display of command file commands 3-18

ERROR — Controls display of the error pointer 3-25

■ 3yc

Display Commands (cont.)

LIST — Lists text on the line printer 3-40

NUMBER — Controls display of lines numbers 3-47

TYPE — Displays text on the system terminal 3-66

Utility Commands

AGAIN — Repeats the last repeatable command 3-6

CRT— Controls the function of the RUBOUT key 3-13

DEBUG — Controls display of the workspace map 3-14

LN — Displays the current line number and workspace

length 3-41

MACRO — Defines or executes a command macro 3-42

PERFROM — Executes commands from a command

file 3-49

QUIT — Aborts the editing session 3-53

STATUS — Displays information about the status of the

editor 3.56

SUSPEND— Suspends the editor 3-60

TAB — Defines the editor tab character 3-61

TABS— Sets new tab stops 3-64

UPARROW — Controls the representation of control

characters 3-69

3-i

8002A Editor Version 3.X

Section 3
COMMAND DICTIONARY

INTRODUCTION

This Command Dictionary alphabetically lists and describes in detail the commands for
version 3.X of the TEKDOS Editor. EDIT, the TEKDOS command that invokes the editor, is
also described in this dictionary. EDIT is listed in alphabetical order between editor
commands ECHO and END.

Dictionary Page Format

Each command entry contains a syntax block, parameter definitions, a general explanation,
and examples.

This Command Dictionary uses the same syntax block conventions as the Command
Dictionary and the Editor Dictionary in the 8002A /^Processor Lab System Users Manual:

• The underlined part of a command name is the shortest form of the command
recognized by the editor.

• Parameters enclosed in braces { } are required.

• Parameters enclosed in brackets [ ] may be omitted.

• Parameters stacked one above the other are alternate forms of the same parameter.

The PARAMETERS section of each entry outlines the functions and limitations of the
parameters. The uses and functions of the command are summarized in the EXPLANATION
section and demonstrated in the EXAMPLES section.

Terminology

The primary input file and primary output file are the default files for those editor
commands that copy text to or from files: COPY, GET, PUT, and PUTK. The editor commands
FILE, FNEXT, and NEXT operate on the primary input file and primary output file exclusively.
When a file is edited, the old version of the file is the primary input file and the edited version
is the primary output file.

Any other file that provides or receives text through one of the above commands is termed an
alternate input file or alternate output file.

The initial command file contains editor commands that are executed before the editor
accepts commands from the system terminal. The initial command file might contain a few
initializing commands or a whole editing session.

@ 3-1

introduction Command Dictionary— 8002A Editor Version 3.X

Primary files, alternate files, and the initial command file are discussed in more detail under
the EDIT command.

The workspace is a section of 8002A program memory that holds the text currently being
edited. The workspace pointer always points to one line of text in the workspace, called the
current line. Many editor commands operate on the current line; other commands move the
workspace pointer, designating a new current line.

A text line may be referenced by its line number, which indicates the line's position in the
workspace. The top line of text is designated line 1, the next line down is line 2, etc. With
certain editor commands, the following three letters may be used as line numbers: B
(beginning of workspace), C (current line), and E (end of workspace).

The Workspace Buffer

The workspace buffer is a section of 8002A program memory used by the editor to store text.
The workspace buffer contains the four areas listed below. Figure 3-1 shows how these four
areas are arranged in the workspace buffer.

• The workspace contains the text being edited. As you add text to the workspace, the
workspace grows toward the end of memory.

• The save area contains the text set aside by the latest SAVE command. The size of the
save area corresponds to the size of the block of text most recently saved.

• The macro area contains any macros defined with the MACRO command. As you define
new macros, the macro area expands, pushing the save area toward the beginning of
memory.

• The free area is the section of available memory between the workspace and the save
area.

The editor program occupies about 9K bytes of program memory. The rest of program memory
constitutes the workspace buffer. In a system with 64K of program memory, 55 bytes of text (about 1400
lines averaging 40 characters each) may be stored in the workspace buffer.

3_2 REV A JUN 1980

Command Dictionary— 8002A Editor Version 3.X

introduction

free area

workspace

i ♦ ♦

free area

TTT

save area

TTT

macro area

workspace

save area

TTT

macro area

(a) (b) (c)

Fig. 3-1. The workspace buffer.

3441-1

When you invoke the editor, the workspace, save area, and macro area are empty, and all of the
workspace buffer is free (Fig. 3-1 a). As text is stored into the workspace and the save area, the two
areas grow toward each other, and the free area diminishes. The macro area grows with each new
macro defined, pushing the save area toward the workspace (Fig. 3-1 b). When no free area remains
(Fig. 3-1 c) the editor responds WORKSPACE FULL. You may recover some free space by moving or
deleting lines from the workspace, by deleting macros, or by replacing the contents of the save area
with a smaller block of text.

Command Lines

Several characters have special meanings in editor command lines:

• The asterisk ("*") is the editor prompt character.

• The colon (":") separates commands in the same line.

• The period (".") immediately following a command name suppresses display of the new
current line after the command executes. (See the BRIEF command.)

• The angle brackets ("<" and ">") enclose a command sequence that is to be repeated a
specified number of times (or until a command in the sequence fails to execute). The
"<" must be preceded by an integer that indicates the number of times the sequence is
to be repeated; or by an asterisk, which says to repeat until a command fails.

3-3

Introduction

Command Dictionary — 8002A Editor Version 3.X

Execution of a command line aborts if the editor detects an error.

The following example demonstrates how these special characters are used.
* the editor prompt

BEG I N . move the workspace pointer to line 1 . The period suppresses
display of that line.

another command follows on the same line.
*< repeat the following sequence until the FIND command fails.

FIND/START HERE/ find the next line that contains the string "START HERE".

another command follows.
KILL delete the "START HERE" line.
: another command follows.

3 SUBSTITUTE. /BAD/GOOD/> replace each

of up to three occurrences of the
string "BAD" in the current line
with the string "GOOD".

> end of sequence.
Go back to FIND.

•BEGIN. :*<FIND/START HERE/ : KILL: 3<SUBSTITUTE ./BAD/GOOD/>>

Special Keys

ESC (Escape)— Erases Line; Halts Command Execution.

Pressing the ESC key once deletes the contents of the line being entered. If the editor is
awaiting a command line, another prompt is supplied.

If the editor is executing a command when you press ESC, the editor finishes the command
being executed but does not continue to the next command in the command line. The editor
displays the message "BREAK" and prompts for a command.

If any of the following commands is executing when ESC is pressed, the editor finishes
transferring only the line being copied.

COPY FILE FN EXT GET NEXT PUT PUTK

If you want to exit temporarily to TEKDOS, use the SUSPEND command. Pressing the ESC
kev twice rapidly is a less reliable way of accomplishing the same thing.

BACKSPACE or RU BOUT— Deletes Character.

The BACKSPACE key and the RUBOUT key have similar functions; either key tells the editor
to discard the last character typed. The RUBOUT key is discussed more fully under the CRT
command.

3-4

Command Dictionary— 8002A Editor Version 3.X Introduction

op3C6 Ssr — ■■ Sits or Hesumes wispisy.

As in TEKDOS, the space bar may be used to halt and resume display of text on the system
terminal.

TAB or CRTL-I— Skips to Next Tab Stop.

The TAB key sends the standard tab character (CTRL-I, ASCII code 09) to the editor. The
cursor moves to the next tab stop. If the last tab stop has been passed, the cursor advances
one space.

3-5

AGAIN

Repeats previous command

Command Dictionary— 8002A Editor Version 3.X

SYNTAX

AGAIN

EXPLANATION

The AGAIN command repeats execution of the latest repeatable editor command, regardless
whether that command was typed in, contained in a macro, or input from a command file,
and regardless whether the command was successfully executed.

The following commands are repeatable with the AGAIN command:

BEGIN

FNEXT

KILL

PUT

SUBSTITU

COPY

FSUBSTITUTE

LIST

PUTK

SUSPEND

DOWN

GET

REPLACE

TYPE

END

INPUT

STATUS

FIND

INSERT

EXAMPLES

Assume that the following text is in the workspace:

► A LINE

ANOTHER LINE

YET ANOTHER

WILL THE LAST LINE EVER COME?

YES, HERE IT IS AT LAST:

»** THE LAST LINE ***

Enter the following command line:

» DOWN. 1:KILL 2

The editor deletes the second and third lines of text.

The workspace now looks like this:

A LINE

► WILL THE LAST LINE EVER COME?

YES, HERE IT IS AT LAST:
*** THE LAST LINE ***

Enter the AGAIN command:

* AGAIN

The editor repeats only the KILL 2 command, not the whole command line.

The workspace now looks like this:
A LINE
► *** THE LAST LINE ***

3-6

Command Dictionary— 8002A Editor Version 3.X

BEGIN

Moves pointer to first line

SYNTAX

BEGIN

EXPLANATION

The BEGIN command moves the workspace pointer to the first line of text and displays the
line. To suppress the display, enter a period after the command.

EXAMPLES

Assume that the following text is in the workspace:

A LINE
ANOTHER LINE

► THE NEXT LINE IS THE

END

Enter the following command. The new current line is displayed.

*BEGIN
A LINE

The workspace now looks like this:

^ A LINE

ANOTHER LINE

THE NEXT LINE IS THE

END

3-7

BRIEF

Controls current-line display

Command Dictionary— 8002A Editor Version 3.X

SYNTAX

BRIEF

tsa

PARAMETERS

ON
OFF

suppresses the current-line display,
reinstates the current-line display.

EXPLANATION

The BRIEF command sets the value of the BRIEF flag. Normally (BRIEF flag OFF), after each of
the following editor commands has finished executing, the new current line is displayed.

BEGIN

END

FN EXT

SUBSTITUTE

DOWN

FIND

FSUBSTITUTE

REPLACE

Turning the BRIEF flag ON causes this current-line display to be suppressed. Turning the flag
OFF reinstates the display.

Entering the BRIEF command without a parameter reverses the value of the BRIEF flag.

When any of the above commands is followed immediately by a period, the action of the
BRIEF flag is reversed for the execution of that command only.

EXAMPLES

Assume that the following text is in the workspace:

►TRUSTWORTHY

LOYAL
HELPFUL
FRIENDLY
COURTEOUS

Enter the following command line:

*DOWN:BRIEF ON: DOWN : BRIEF OFF : DOWN: DOWN.

3-8

BRIEF

Command Dictionary— 8002A Editor Version 3.X Controls current-line display

The first DOWN moves the works n ace n ointer to the second line and dis n !a w s it'

LOYAL

The second DOWN moves the pointer to the third line, but does not display it because the
BRIEF flag has been turned ON. The third DOWN moves the pointer to the fourth line and
displays it because BRIEF is OFF again:

FRIENDLY

The last DOWN moves the pointer to the fifth line, but the current-line display is suppressed
by the period following DOWN. This period turns the BRIEF flag back ON for that command
only.

@ 3.9

COMMENT

Inserts comment in command input

Command Dictionary— 8002A Editor Version 3.X

SYNTAX

COMMENT [text]

PARAMETERS

text

any line of text

EXPLANATION

The word COMMENT identifies a comment in command input. The rest of the line following a
COMMENT command is ignored by the editor. The editor displays the COMMENT line on the
system terminal (if the ECHO flag is ON) and proceeds to the next command.

EXAMPLES

Assume that disc file EXAMPLE contains the following text:

COM THIS COMMAND FILE MOVES THE POINTER TO THE END OF THE WORKSPACE,

END

COM »»• END OF EXAMPLE ***

Enter the following command:

•PERFORM EXAMPLE

The editor executes the command file, moving the pointer to the end of the workspace and
displaying each command as it is executed. The editor responds as follows:

*C0M THIS COMMAND FILE MOVES THE POINTER TO THE END OF THE WORKSPACE.
»END

«» E oF
*C0M *** END OF EXAMPLE ***

3-10

COPY

Command Dictionary— 8002A Editor Version 3.X

Copies text without affecting workspace

COPY

SYNTAX

number of lines"]

range of lines J [{input file[/disc] | [output file[/disc]] ]

PARAMETERS

number of lines number of lines to be copied.

range of lines range of lines to be copied, for example 2-6. B, C, and E may not be

used as line numbers in a COPY command.

input file
output file

disc

name of the file or device from which text is copied.

name of the file or device to which text is copied. To specify the primary
output file, omit this parameter.

number of the disc drive unit on which the specified file is stored. If no
drive is specified, the system disc is assumed.

EXPLANATION

The COPY command copies text from a disc file or device to another disc file or device
without affecting the workspace contents or pointer. Copying ends when the specified lines
have been copied or when the end of the input file is reached.

If neither a number of lines nor a range of lines is specified, one line is copied.

If an alternate input file is specified, copying begins at the beginning of that file or at the first
line in the specified range. If an alternate output file is specified, its contents are replaced
with the copied text. If the alternate output file specified did not exist previously, it is created.

If you do not specify an alternate input file or device, or if you specify the primary input file by
name, text is copied from the primary input file.

• If you specify a number of lines, copying begins at the primary input file pointer.

• If you specify a range of lines, those lines are copied regardless of the position of the
pointer.

• In any case, after copying the primary input file pointer is at the line following the last
line copied.

3-11

COPY

Copies text without affecting workspace Command Dictionary — 8002A Editor Version 3.X

You may not copy to the primary input file or from the primary output file.

If you specify an output file or device, you must also specify an input file or device.

EXAMPLES

*COPY

appends one line from the primary input file to the primary output file. The primary input file
pointer advances one line.

•COPY 10-20 FILE1/0

skips over the first 9 lines of FILE1 on disc drive and appends lines 10-20 to the primary
output file.

•COPY 15 FILE2 FILE3/1

replaces the contents of FILE3 on disc drive 1 with the first 15 lines of FILE2 on the system
disc.

•COPY 1000 FILE4 C0N0

displays on the system terminal (CONO) the first 1000 lines of FILE4 on the system disc. If
FILE4 contains fewer than 1000 lines, the message ** EOF is displayed after copying ends.

3-12 REVAJUN1980

Command Dictionary — 8002A Editor Version 3.X

CRT

Controls function of KUBOUT key

SYNTAX

roN-i

CRT LOFFJ

ON
OFF

PARAMETERS

causes RUBOUT to backspace over the deleted character,
causes RUBOUT to echo the deleted character.

EXPLANATION

The CRT command sets the value of the CRT flag.

!f your system terminal is a TV-type device, you will probably want to leave the CRT flag at its
initial value (ON). Users of hard-copy terminals may find it easier to keep track of deleted
characters if they turn the CRT flag OFF.

The RUBOUT key is used to delete the last character typed from the input text or command
line. Normally (CRT flag ON) RUBOUT also erases the deleted character from the screen and
backspaces the cursor. Turning the CRT flag OFF causes RUBOUT to echo the deleted
character on the terminal instead.

Entering the CRT command without a parameter reverses the value of the CRT flag.

EXAMPLES

Enter the following command line. (Each @ represents a RUBOUT.)

* INSERT 123456§@@

If you are using a hard-copy terminal, what you see depends on the type of terminal. A TV
terminal would display:

*INSERT 123

Now turn the CRT flag OFF and enter the same command line again:

« CRT OFF

' INSERT 123456gg@

What you see is different...

*INSERT 123^56654

but the result is the same. Display the two lines entered:

*U P.2:TYPE 2

Both lines are the same:

123
123

<s>

3-13

DEBUG

Controls display of workspace map

Command Dictionary— 8002A Editor Version 3.X

SYNTAX

DEBUG

ON
OFF

PARAMETERS

causes the workspace map to be displayed after every command.

suppresses display of the workspace map.

EXPLANATION

The DEBUG command sets the value of the DEBUG flag.

Normally (DEBUG flag OFF) the workspace map is not displayed. Turning the DEBUG flag ON
causes the workspace map to be displayed every time a command is executed. Turning the
DEBUG flag OFF suppresses the display.

Entering the DEBUG command without a parameter reverses the value of the DEBUG flag.

The workspace map shows the locations of the four areas of the workspace buffer: the
workspace, the free area, the save area, and the macro area. You may want to check the map
whenever you suspect that the workspace buffer is full or nearly full of text.

The map has the following format:

WSP pppp-tttt, FREE qqqq-rrrr, SAVE ssss, REL xxxx-yyyy ( z)

LCNT= m, CNUM= n (uuuu)

You may interpret the workspace map as follows:

The workspace buffer begins at address pppp and ends
at address tttt.

The free area begins at address qqqq and ends at
address rrrr.

The save area ends at byte ssss.

Indicates a "relocatable"
area of memory. These
numbers are of no use to
the user.

WSP pppp-tttt, FREE qqqq-rrrr, SAVE ssss, REL xxxx-yyyy ( z)
LCNT= m, CNUM= n (uuuu)

Line n is the current line in the workspace. The
address of the first byte of the current line is uuuu.

There are m lines of text in the workspace.

3-14

(5)

DEBUG

Command Dictionary— 8002A Editor Version 3.X

Controls display of workspace map

The values pppp through uuuu are hexadecimal addresses in program memory; the locations
they represent are shown on the diagram below.

uuuu

workspace

Tree area

save area

macro area

PPPP

qqqq-1

qqqq

rrrr
rrrr+1

ssss
ssss+1

tttt

EXAMPLES

Assume that the workspace contains the following text:

THE USUAL NONSENSE
SOME UNUSUAL NONSENSE

► SOME NONUSUAL UNSENSE

SOME UNUSABLE INCENSE

Enter the following command to turn the DEBUG flag ON:

•DEBUG ON

Before prompting for another command, the editor checks the DEBUG flag. Because the
DEBUG flag is ON, the editor displays the workspace map:

WSP 2324-9EB9, FREE 2379-9EB9, SAVE 9EB9, REL 2379-9EB9 ( 0)

LCNT= 4, CNUM= 3 (234D)

From this map you can determine that the workspace occupies bytes 2324-2378 of program
memory. Also, because the free area extends all the way to the end of the workspace buffer,
you know that the save and macro areas are empty. There are four lines in the workspace,
and the current line, line 3, begins at byte 234D.

Enter the following command to copy the workspace contents into the save area:

• SAVE B-E

WSP 2324-9EB9, FREE 2379-9E64, SAVE 9EB9, REL 2379-9EB9 ( 0)

LCNT:

4, CNUM=

3 (234D)

Now the save area occu n ies bytes 9E65-9EB9. No other information has changed.

3-15

DEBUG

Controls display of workspace map

Command Dictionary— 8002A Editor Version 3.X

When you define a macro, the command line of the macro is stored in the macro area.

» MACR01=TYPE B-E

WSP 2324-9EB9, FREE 2379-9E5A, SAVE 9EAF, REL 2379-9EB9 ( 0)

LCNT= 4, CNUM= 3 (234D)

The macro is saved in bytes 9EB0-9EB9, pushing the save area into bytes 9E5B-9EAF. The
workspace is unaffected.

Note that as long as the DEBUG flag is ON, the workspace map appears every time a
command executes. Enter the following command line:

*BEGIN:DOWN

THE USUAL NONSENSE

WSP 2324-9EB9, FREE 2379-9E5A, SAVE 9EAF, REL 2379-9EB9 ( 0)

LCNTr 4, CNUM= 1 (2324)

SOME UNUSUAL NONSENSE

WSP 2324-9EB9, FREE 2379-9E5A, SAVE 9EAF, REL 2379-9EB9 ( 0)

LCNT= 4, CNUM= 2 (2337)

The BEGIN command moves the workspace pointer to the first line, displays the new current
line, and displays the workspace map. The DOWN command moves the pointer down to line
2, displays the line, and displays the workspace map.

Enter the following command line to turn the DEBUG flag OFF and display the current line:

*DEBUG 0FF:TYPE

SOME UNUSUAL NONSENSE

3-16

Command Dictionary— 8002A Editor Version 3.X

DOWN

Moves pointer down

DOWN [number of lines]

SYNTAX

PARAMETERS

number of lines number of lines the pointer moves down.

EXPLANATION

The DOWN command moves the workspace pointer the specified number of lines toward the
end of the workspace.

If you do not specify a number of lines, the pointer moves down one line.

The new current line is displayed. To suppress the display, enter a period immediately after
the command, before any space or number.

If moving the pointer the specified number of lines would place the pointer past the end of
the workspace, the pointer stops one line below the last text line and the message ** END OF
TEXT is displayed.

EXAMPLES

Assume that the workspace contains the following text:

A LINE

► A SECOND LINE

HOW MANY LINES
DO I HAVE?
FIVE LINES

Enter the following command. The new current line is displayed.

« DOWN 2
DO I HAVE?

The workspace now looks like this:

A LINE

A SECOND LINE
HOW MANY LINES
•DO I HAVE?
FIVE LINES

3-17

ECHO

Controls display of command file commands

Command Dictionary— 8002A Editor Version 3.X

ton]

ECHO LOFFj

SYNTAX

ON
OFF

PARAMETERS

causes command file lines to be echoed on the system terminal,
suppresses the command-line display.

EXPLANATION

The ECHO command sets the value of the ECHO flag.

When an editor command file is performed, each command line is first displayed on the
system terminal and then executed. Turning the ECHO flag OFF causes the command-line
display to be suppressed. Turning the flag ON reinstates the display.

Entering the ECHO command without a parameter reverses the value of the ECHO flag.

The ECHO flag is initially ON.

EXAMPLES

Assume that disc file SAMPLE contains the following text:

COM THIS LINE WILL BE PRINTED.

ECHO OFF

COM THIS LIME WON'T BE.

ECHO:COM REVERSE THE ECHO FLAG FROM OFF TO ON.

COM THIS LINE WILL ALSO BE PRINTED.

Execute the command file:

^ PERFORM SAMPLE

The following lines will be displayed on the system terminal:

•COM THIS LINE WILL BE PRINTED,

"ECHO OFF

*COM THIS LINE WILL ALSO BE PRINTED.

3-18

EDIT

Command Dictionary— -8002A Editor Version 3.X invokes editor

SYNTAX
EDIT [ infile[/disc]] [ outfile[/disc]] [ comfile[/disc]]

PARAMETERS

infile name of the primary input file.

outfile name of the primary output file.

comfile name of the initial command file.

disc number of the disc drive unit on which the specified file is stored. If no

drive is specified, the system disc is assumed.

EXPLANATION

The TEKDOS command EDIT invokes the editor and specifies:

• the file that contains the text to be edited (the primary input file);

• the file on which the edited text will be saved (the primary output file);

• the file that contains a series of editor commands to be executed at the beginning of the
editing session (the initial command file).

Editing Options

A typical editing session proceeds as follows:

1 . Text is copied from the primary input file to the workspace with the commands GET,
NEXT, or FNEXT.

2. Text in the workspace is modified with various editor commands.

3. Text is copied from the workspace to the primary output file with the commands FILE,
NEXT, or FNEXT.

You may add text to the workspace from sources other than the primary input file. The INPUT
command allows you to enter text from the system terminal. The GET command is used to
copy text from other files.

You may use the commands PUT or PUTK to save text from the workspace onto files other
than the primary output file.

3-19

EDIT

Invokes editor Command Dictionary — 8002A Editor Version 3.X

Primary and Alternate Files

Any file, other than the primary input file and the primary output file, may serve as an
alternate input file (a file that provides text) or an alternate output file (a file that receives
text).

The primary input file differs from alternate input files in the following ways:

• Copying from an alternate input file always begins at the beginning of the file. Copying
from the primary input file generally begins at the primary input file pointer, which
points to the line following the last line copied.

• An alternate input file must be specified by name in a GET or COPY command. The
primary input file is the default input file for GET and COPY.

• The commands FILE, NEXT, and FNEXT can copy text only from the primary input file.

The primary output file differs from alternate output files in similar ways:

• Text copied to an alternate output file always replaces the previous contents of the file.
(If the file did not exist, it is created.) Text copied to the primary output file is generally
appended to the end of the file.

• An alternate output file must be specified by name in a PUT, PUTK, or COPY command.
The primary output file is the default output file for PUT, PUTK, and COPY.

• The commands FILE, NEXT, and FNEXT can copy text only to the primary output file.

The Initial Command File

An editor command file contains a series of editor commands; these commands are identical
to any that you may enter from the system terminal. You may specify an editor command file
as the third parameter in the EDIT command line. The editor executes the commands from
that file (called the initial command file) before accepting commands from the system
terminal. If the editor encounters a FILE or QUIT command in the initial command file, the
editing session ends.

Useful Invocations

The four useful forms of the EDIT command are described here. Each form may include or
omit the optional third parameter. In the following discussion:

• oldfile represents any existing file;

• newfile represents a non-existent file;

• comfile represents the initial command file.

3-20 @

EDIT

Command Dictionary— 8002A Editor Version 3.X invokes editor

The two most commonly used forms of the EDIT command are EDIT newfile and EDIT
oldfile. Two other invocations you may find useful are EDIT (no parameters) and EDIT oldfile
nevvfile.

1. EDIT newfile or EDIT newfile,, comfile

This invocation begins the editing session that creates disc file newfile. There is no
primary input file. You may enter text from the system terminal or add text from
alternate input files. The FILE command copies the text in the workspace to the
primary output file, saves the primary output file under the name newfile, and ends
the editing session.

2. EDIT oldfile or EDIT oldfile„comfile

This invocation begins an editing session that modifies disc file oldfile, which becomes
the primary input file. A temporary primary output file is created. You may use the
commands GET, NEXT, or FNEXT to bring text from oldfile into the workspace. You
may modify the text in the workspace, bring in additional text from alternate input
files, or copy text to alternate output files.

When you close the editing session with a FILE command, the edited version of oldfile
is copied to the primary output file. The primary output file is saved under the name
oldfile, and the primary input file is given a backup name, oldfile*. If a file called
oldfile* already exists, that file is lost.

If you abort the editing session with a QUIT command, the primary output file is lost
and the primary input file retains the name oldfile.

The "Backup Names" paragraph that follows explains how the editor chooses a backup
name for the primary input file.

3 EDIT or EDIT,„comfile

You may use this invocation when you have no use for a primary input file or a primary
output file (for example, when you are sorting out text among several files). All text
must be entered from the system terminal or copied from alternate input files. The text
must be saved on alternate output files. You must use the QUIT command to end the
editing session.

4. EDIT oldfile newfile or EDIT oldfile newfile comfile

This invocation allows you to create a modified version of oldfile on newfile. Oldfile is
not affected. Oldfile is the primary input file and newfile is the primary output file.
When you close the editing session with a FILE command, the edited version of oldfile
is copied to the primary output file, newfile. If you abort the editing session with a
QUIT command, newfile is lost.

Avoid any invocations other than these four.

@ 3-21

EDIT

Invokes editor

Command Dictionary— 8002A Editor Version 3.X

Invocations to Avoid

If you specify an existing file as the primary output file, the editor responds ** SUPERSEDING
EXISTING FILE. The previous contents of the file are lost unless you exit with a QUIT
command before copying any text to the primary output file.

If you specify a non-existent file as the primary input file, the editor responds

** CANNOT READ NEW FILE
** PRIMARY INPUT

and designates no primary input file.

If you specify the same file as both the primary input file and the primary output file:

• If the file exists, the invocation is equivalent to EDIT oldfile

• If the file does not exist, the editor responds

»* CANNOT READ NEW FILE

** PRIMARY INPUT

** SUPERSEDING EXISTING FILE

and designates neither a primary input file nor a primary output file.

Backup Names

The editor derives a name for a backup file as follows:

1. If the file name is one to seven characters long, an asterisk (*) is added to the end.

2. If the file name is eight characters long, the last character is replaced with an asterisk.

3. If the file name is eight characters long and the last character is already an asterisk,
the first character is replaced with an asterisk.

4. If the file name is eight characters long and both the first and last characters are
asterisks, the backup file is not saved.

For example:

file name

NAME

NAME*

LONGNAME

LONGNAM*

*ONGNAM*

backup name

NAME*
NAME**
LONGNAM*
*ONGNAM*
(backup file lost)

3-22

EDIT

Command Dictionary— 8002A Editor Version 3.X Invokes editor

EXAMPLES

> EDIT PR0G;S

begins the editing session that creates or modifies file PROG;S on the system disc. If PROG;S
already exists, it serves as the primary input file. When you close the editing session with a
FILE command, the edited version (the primary output file) takes the name PROG;S and the
old version (the primary input file) takes the name PROG;S*. If PROG;S did not exist
previously, there is no primary input file. When you enter the FILE command, the primary
output file is saved under the name PROG;S.

> EDIT DIRTY CLEAN/1

begins the editing session that modifies text from file DIRTY on the system disc and stores
the text in file CLEAN on disc 1. DIRTY is the primary input file and CLEAN is the primary
output file. If CLEAN did not previously exist, it is created. If CLEAN already exists, the editor
responds ** SUPERSEDING EXISTING FILE, and the current contents of CLEAN are lost
unless you exit with a QUIT command before copying any text to the primary output file.

@ 3-23

END

Moves pointer to end

Command Dictionary— 8002A Editor Version 3.X

EXPLANATION

The END command moves the workspace pointer one line beyond the last line of text and
displays the message ** END OF TEXT. To suppress the display, enter a period after the
command.

EXAMPLES

Assume that the workspace contains the following text:

ONE

► TWO

I THINK
I'M THROUGH

Enter the following command to move the pointer one line past the last line of text. The
editor displays the message ** END OF TEXT.

*END

"END OF TEXT

The workspace now looks like this:

ONE

TWO

I THINK

I'M THROUGH

3-24

Command Dictionary — 8002A Editor Version 3.X

bnnUn

Controls display of error pointer

SYNTAX

roNi

ERROR LOFFJ

PARAMETERS

ON
OFF

reinstates display of the error pointer,
suppresses display of the error pointer.

EXPLANATION

The ERROR command sets the value of the ERROR flag.

Whenever an error is found during the interpretation or execution of a command, the editor
displays an appropriate error message. Normally (ERROR flag ON) the command line is also
displayed, with a pointer (A or f) below the last character of the illegal command or
parameter. When the ERROR flag is turned OFF, display of the command line and pointer is
suppressed. Turning the flag ON reinstates the display.

Entering the ERROR command without a parameter reverses the value of the ERROR flag.

The ERROR flag is initially ON.

EXAMPLES

Enter the following command line:

* HELP ME!

The editor displays an error message, lists the command line, and points to the the last
character of the illegal command HELP.

** UNKNOWN COMMAND

** HELP ME!
**

Turn the ERROR flag OFF and enter the illegal command again:

"ERROR OFF
* HELP ME !

Onlv thp> prrnr mptjc^ne ic HicnlawoH
** UNKNOWN COMMAND

(5)

3-25

FILE

Closes editing session Command Dictionary— 8002A Editor Version 3.X

SYNTAX
FILE

EXPLANATION

The FILE command ends a normal editing session, causing the following to happen:

1. The contents of the workspace are appended to the primary output file.

2. Any remaining text in the primary input file is appended to the primary output file.

3. If the name of the primary output file was not specified in the EDIT command line or
was the same as the name of the primary input file:

a. The primary output file (to which the editor has given a temporary name) is given
the name of the primary input file.

b. The primary input file is renamed to a backup file name, replacing the existing
backup file, if any. The backup file name is formed by appending "*" to the name
of the primary input file. See the EDIT command for a complete explanation of
how the editor derives a name for a backup file.

If neither a primary input file nor a primary output file was specified in the EDIT command
line, then you must use the QUIT command to exit from the editor. If you were to enter a FILE
command, the editor would respond ** NO OUTPUT FILE SPECIFIED and do nothing. The
editor thus guards against accidental loss of the workspace contents.

EXAMPLES

Use the editor to modify system disc file PROG;S:

> EDIT PROG;S

** EDIT VERSION 3.0
* Edit the contents of PROG;S.

» FILE

T"TND OF TEXT

*« EOF
*D0S* EOJ

Two versions of PROG;S now exist: unmodified (PROG;S*) and modified (PROG;S).

3-26

(a)

FIND

Command Dictionary — 8002A Editor Version 3.X Searches workspace for string

SYNTAX

FIND {/string/}

PARAMETERS

string delimiter: any character except a space. The delimiter character must not
occur in the string. Both delimiters must be the same character. If the delimiter
character is a letter or period, a space must separate the command from the first
delimiter. The final delimiter may be omitted if it is the last character in the
command line.

string the string of characters to be found.

EXPLANATION

The FIND command searches for the specified string, beginning at the current line and
proceeding toward the end of the workspace.

If the string is found, the workspace pointer moves to the line containing the string and the
line is displayed. To suppress the display, enter a period between the command and the first
delimiter.

If the string is not found, the workspace pointer does not move and the message ** NOT
FOUND is displayed.

If you enter the AGAIN command to repeat a FIND command, the search begins one line
down from the current line, so that the same line is not found again.

If a FIND command inside repeat brackets ("<" and ">") fails to find a match, execution
resumes with the next command outside the brackets.

If you are using tab stops, remember that while each tab character in your text is displayed
as one or more spaces, it is stored as a single character. To include a standard tab character
in your search string, press the TAB key at the appropriate place in the command line.

See the XSEARCH command for an explanation of special search characters.

REVAJUN1980 3-27

FIND

Searches workspace for string Command Dictionary— 8002A Editor Version 3.X

EXAMPLES

Assume that the workspace contains the following text:

► I THINK

I SEE
A LINE
FOR ME

Enter the following command:

» FIND/A/

The workspace pointer moves to line 3. That line is displayed.

A LINE

The workspace now looks like this:

I THINK
I SEE

► A LINE

FOR ME

The FIND command searches the text beginning at the current line. The search will fail if the
search string does not occur in or after the current line.

» FIND/THINK/
** NOT FOUND

3-28

FN EXT

Command Dictionary— 8002A Editor Version 3.X Searches file for string

SYNTAX

FNEXT {/string/}

PARAMETERS

string the string of characters to be found.

EXPLANATION

The FNEXT command searches from the current line through the workspace, then through
the rest of the primary input file, until the string is found. When no match is found in the
current contents of the workspace, they are appended to the primary output file and the
workspace is filled to three-fourths of its capacity with text from the primary input file. The
search then continues from the first line of the new workspace contents.

When a match is found, the line containing the specified string becomes the current line.
That line may occur anywhere in the workspace.

If no match is found, the command is terminated. At that time, the workspace is empty and
the primary input file is at its end.

If you enter the AGAIN command to repeat the FNEXT command, the search begins one line
after the current line, so that the same line is not found again.

If an FNEXT command inside repeat brackets ("<" and ">") fails to find a match, execution
resumes with the next command outside the brackets.

See the XSEARCH command for an explanation of special search characters.

REV A JUN 1980 3-29

FNEXT

Searches file for string

Command Dictionary— 8002A Editor Version 3.X

EXAMPLES

If the search string occurs in the workspace at or after the current line, FNEXT acts the same
as FIND. Assume that the following text is in the workspace:

► NOT ME

NOPE
HERE I AM

Enter the following command:

"FNEXT/HERE/

The line containing the string "HERE" becomes the current line.

NOT ME
NOPE
HERE I AM

Now consider a case in which the text you want to edit is not in the workspace. Assume that
the next line to be edited contains the string "DOWN HERE" and occurs toward the end of
the primary input file. The diagram below shows the contents of the workspace and the
primary files. Note the positions of the primary input file pointer and the workspace pointer.

primary

input

file

UNMODIFIED

TEXT

NOT ME

MANY
LINES

SOME TEXT
DOWN HERE
MORE TEXT

AND SO ON

workspace

NOT ME
NOPE
HERE I AM

primary

output

file

MODIFIED
TEXT

Enter the following command:

*FNEXT/DOWN HERE/

3-30

<a>

Command Dictionary— 8002A Editor Version 3.X

FN EXT

Searches file for string

When the editor fails to find the string in the current workspace, it appends the workspace
contents to the primary output file. Then it copies sections of text from the primary input file,
through the workspace, to the primary output file, until the section that contains the string is
brought into the workspace.

After execution of the command, this is what you have:

primary

input

file

nuurtntr Ten
u nnuuir ilk

TEXT
NOT ME

MANY
LINES

SOME TEXT
DOWN HERE
MORE TEXT

AND SO ON

workspace

?nur TtrvT

u v/n l^ 1LA1

DOWN HERE

MORE TEXT

primary

output

file

unnT it tit r\
nuuir icu

TEXT

NOT ME

NOPE

HERE I AM

MANY

LINES

(a)

3-31

FSUBSTITUTE

Finds and replaces string Command Dictionary — 8002A Editor Version 3.X

SYNTAX
FSUBSTITUTE {/search string/new string/}

PARAMETERS

/ string delimiter: any character except a space. The delimiter character must not

occur in either string. All three delimiters must be the same character. If the
delimiter character is a letter or period, a space must separate the command from
the first delimiter. The final delimiter may be omitted if it is the last character in
the command line.

search string the string of characters you want to replace.

new string the string of characters that replaces the search string.

EXPLANATION

The FSUBSTITUTE command combines the functions of the commands FIND and
SUBSTITUTE. Beginning at the current line, the editor searches the workspace for the search
string. If the search string is found, the line that contains it becomes the current line and the
new string replaces the search string. If no match is found, the message ** NOT FOUND is
displayed and the workspace pointer remains at the same line.

The strings may be of different lengths. If the new string is empty, the search string is
deleted.

After the substitution, the modified line is displayed. To suppress the display, enter a period
between the command and the first delimiter.

If the modified line exceeds 127 characters, the line is truncated to 127 characters and the
editor displays the message ** TRUNCATED along with the truncated line.

If an FSUBSTITUTE command inside repeat brackets ("<" and ">") fails to find a match,
command execution resumes with the next command outside the brackets.

if you are using tab stops, remember that while each tab character in your text is displayed
as one or more spaces, it is stored as a single character. To include a standard tab character
in your search string or new string, press the TAB key at the appropriate place in the
command line.

See the XSEARCH command for an explanation of special search characters.

3-32 REV A JUN 1980

FSUBSTITUTE

Command Dictionary— 8002A Editor Version 3.X Finds and replaces string

CAMIVIfLCS

The following text is in the workspace:

^ yes yes yes

yes yes
NO NO NO
yes yes

urn

Enter the following command:

*FS/N0/yes/

The first occurrence of the string "NO" is on line 3. That line becomes the current line and is
displayed as modified:

yes NO NO

You may enclose an FSUBSTITUTE command in repeat brackets to make the same text
substitution any number of times; however, be sure that the new string does not contain the
search string. For example, the command line

5<FS/MAN/W0MAN/>
replaces the first occurrence of "MAN" with the string "WOWOWOWOWOMAN".

(a 3-33

GET

Reads text from file into workspace

Command Dictionary— 8002A Editor Version 3.X

SYNTAX

[number of lines"
range of lines J [input file[/disc]]

PARAMETERS

number of lines
range of lines

input file
disc

number of lines to be read.

range of lines to be read, for example 2-6. B, C, and E may not be
used as line numbers in a GET command.

name of the file or device from which text is copied. To specify the
primary input file, omit this parameter.

number of the disc drive unit on which the specified file is stored. If no
drive is specified, the system disc is assumed.

EXPLANATION

The GET command reads text from a disc file into the editor workspace. The text is inserted
before the current line. The workspace pointer does not move.

Copying ends when the specified lines have been copied or when the end of the input file is
reached.

If neither a number of lines nor a range of lines is specified, one line is copied.

If an input file is specified, copying begins at the beginning of the file or at the first line in the
specified range. You may not specify the primary input file by name, and you may not specify
the primary output file at all.

If an input file is not specified, text is copied from the primary input file.

• If you specify a number of lines, copying begins at the primary input file pointer.

• If you specify a range of lines, those lines are copied, regardless of the position of the
primary input fiie pointer.

• Afterward, in either case, the primary input file pointer is at the line following the last
line copied.

3-34

GET

Command Dictionary — 8002A Editor Version 3.X

Reads text from file into workspace

EXAMPLES

*GET 30 FILE1

copies the first 30 lines of system disc file FILE1 into the workspace, inserting them before
the current line.

*GET 10-20

copies lines 10-20 from the primary input file into the workspace, inserting them before the
current line. Afterward, the primary input file pointer is at line 21 .

•GET

inserts the next line from the primary input file into the workspace. The primary input file
pointer advances one line.

<a>

3-35

INPUT

Inputs text from system terminal into workspace Command Dictionary — 8002A Editor Version 3.X

SYNTAX
INPUT

EXPLANATION

The INPUT command allows you to type any number of text lines into the workspace. INPUT
places the editor in input mode. All text entered in input mode, up to (but excluding) the first
empty line, is inserted into the workspace before the current line.

An empty line (carriage return only) terminates input mode, but a blank line (one or more
spaces followed by a carriage return) is treated like any other text line.

The current line remains the same.

There is no prompt character in input mode.

If a text line exceeds 127 characters, the editor displays the message ** TRUNCATED. The
line you entered is replaced with the text line ** TRUNCATED.

If an INPUT command is executed from a command file, the editor accepts text lines from the
command file rather than from the keyboard. The command file must contain an empty line
at the end of the input text. Although you cannot use INPUT or INSERT to create an empty
line, you may use the following command line to insert an empty line after the current line:

» XSEARCH ON:FS/>/>>/

EXAMPLES

To create text in an empty workspace, enter:

"INPUT

The editor responds:

INPUT:

Enter the following lines:

DICE 3 POTATOES INTO SAUCEPAN,

ADD 1 CUP CHOCOLATE SYRUP.

CHILL 15 MItf. BEFORE SERVING.

3-36 <s>

INPUT

Command Dictionary— 8002A Editor Version 3.X Inputs text from system terminal into workspace

Aftor torminatinn tho thirrl lino \«/ith o porriono rntnm <-».-.+^..- ~> ^^^^^^1 ^„-..;„,,,^ i....— *„

,,,iv " •■'-' uiiii s «■■ ■'-' »"'« mivy vvilii u v/oniuyc iciuin, ciiici a scuui iu oaiiiaye iciuiii iu

terminate input mode.

The workspace now looks like this:

DICE 3 POTATOES INTO SAUCEPAN.
ADD 1 CUP CHOCOLATE SYRUP.
CHILL 15 MIN. BEFORE SERVING.

To insert text between lines 2 and 3, move the workspace pointer to line 3:

The new current line is displayed.

CHILL 15 MIN. BEFORE SERVING.

Add the following text:

* INPUT

INPUT:

STIR BRISKLY 30 SEC.

DRAIN OFF EXCESS SYRUP.

The workspace now looks like this:

DICE 3 POTATOES INTO SAUCEPAN,
ADD 1 CUP CHOCOLATE SYRUP.
STIR BRISKLY 30 SEC.
DRAIN OFF EXCESS SYRUP.
► CHILL 15 MIN. BEFORE SERVING.

<® 3-37

INSERT

Inserts line into workspace Command Dictionary— 8002A Editor Version 3,X

SYNTAX

INSERT [text]

PARAMETERS

text any line of text. An INSERT command without text is interpreted as an

INPUT command.

EXPLANATION

The INSERT command inserts one line of text into the workspace immediately preceding the
current line.

One or more spaces must separate the INSERT command from the text. The text may not
begin with a space.

If the command line, including the text, exceeds 127 characters, the editor displays the
message ** COMMAND INPUT ABORTED and the command line is lost.

EXAMPLES

Assume that the workspace contains the following text:

THERE WAS A LITTLE HEN
AND SHE HAD A WOODEN LEG

^ SHE COULD LAY MORE WOODEN EGGS THAN ANY HEN ON THE FARM

ANOTHER LITTLE DRINK WON'T DO US ANY HARM

Enter the following command:

» INSERT THE BEST LITTLE HEN THAT EVER LAID A WOODEN EGG

The workspace now looks like this:

THERE WAS A LITTLE HEN

AND SHE HAD A WOODEN LEG

THE BEST LITTLE HEN THAT EVER LAID A WOODEN EGG

m- SHE COULD LAY MORE WOODEN EGGS THAN ANY HEN ON THE FARM

ANOTHER LITTLE DRINK WON'T DO US ANY HARM

3-38 @

Command Dictionary— 8002A Editor Version 3.X

KILL

Deletes lines from workspace

KILL

"number of lines"
range of lines

SYNTAX

PARAMETERS

number of lines number of lines to be deleted, beginning with the current line.

range of lines range of lines to be written, for example 2-6. B, C, and E may be

used to represent the first line, current line, and end of workspace,
respectively.

EXPLANATION

The KILL command deletes the indicated lines of text from the workspace.

If you do not specify a number of lines or a range of lines, only the current line is deleted.

The workspace pointer does not move unless the current line is deleted, in which case the
first line after the deleted text becomes the current line.

EXAMPLES

•KILL
deletes the current line.

*KILL 10
deletes 10 lines beginning with the current line.

•KILL 20-C
deletes all text between line 20 and the current line, inclusive.

<a>

3-39

LIST

Lists text on line printer

Command Dictionary— 8002A Editor Version 3.X

Tnumber of lines'
LIST |_range of lines

SYNTAX

PARAMETERS

number of lines
range of lines

number of lines to be listed, beginning with the current line.

range of lines to be saved, for example 2-6. B, C, and E may be used
to represent the first line, current line, and end of workspace,
respectively.

EXPLANATION

The LIST command lists the specified lines of workspace text on the line printer.

The workspace contents and pointer are not affected.

If neither a number of lines nor a range of lines is specified, only the current line is listed.

EXAMPLES

*LIST
lists the current line.

•LIST 10
lists 10 lines, beginning with the current line.

»I T C T C 1 C
"U J. O 1 J— I J

lists workspace lines 5 through 15.

3-40

(a 1

Command Dictionary— 8002A Editor Version 3.X

Displays current line number and workspace length

SYNTAX

EXPLANATION

The LN command displays the line number of the current line and the number of lines in the
workspace.

EXAMPLES

Assume that the workspace contains the following text:

AS I WAS STANDING IN THE STREET,
AS QUIET AS CAN BE,

► A GREAT BIG UGLY MAN CAME UP,

AND TIED HIS HORSE TO ME.

Enter the following command:

*LN

The editor reports the current line number and line count.

00003 (00004)

3-41

MACRO

Defines or executes a command macro Command Dictionary— 8002A Editor Version 3.X

SYNTAX
MACRO [number [^[command tine]]]

PARAMETERS

number macro identification number: any integer from 1 to 127.

command line the command line represented by this macro.

EXPLANATION

The MACRO command stores command lines that will be used repeatedly. MACRO is also
used to execute those command lines, to list any presently defined macros, and to delete
macros.

To define a macro, enter MACRO, the number, the equals sign, and the command line. Any
macro definition previously associated with that number is lost. No spaces are necessary
except those that are required by the commands in the command line.

To delete a macro, enter MACRO, the identifying number, and the equals sign.

To execute a macro, enter MACRO and the identifying number.

To list the macros you have defined, enter MACRO with no parameters.

A macro may invoke other macros, but not itself. A macro may not contain a macro
definition.

A macro may not delete a macro or contain a perform command.

EXAMPLES

Enter the following command to define a macro that displays 10 lines and then advances the
pointer 10 lines:

*MACR05=TYPE10:DOWN. 10

If the workspace pointer is on line 14 and you enter MACR05, lines 14 to 23 will be
displayed. Since the TYPE command does not move the pointer, the DOWN command is used
to move the pointer down 1 lines to the new current line, number 24. The current line is not
displayed, since the period after the DOWN command suppresses the display.

3-42 REV A JUN 1980

Command Dictionary — 8002A Editor Version 3.X

MACRO

Defines or executes a command macro

To execute the macro, enter:

*MACR05

To display all the macros you have defined, enter:

•MACRO

To delete macro 5, enter:

*MACR05=

3-43

MOVE

Muves text within workspace

Command Dictionary— 8002A Editor Version 3.X

SYNTAX

(number of lines)

MOVE irange of lines j

[line number]

number of lines
range of lines

line number

PARAMETERS

number of lines to be moved, beginning with the current line.

range of lines to be deleted, for example 2-6. B, C, and E may be
used to represent the first line, current line, and end of workspace,
respectively.

line number of the destination line. B, C, or E may also be used if the
text is to be inserted before the first line, current line, or end of
workspace. E is the default destination line.

EXPLANATION

The MOVE command deletes the specified lines from their current position in the workspace
and inserts them before the destination line.

If the destination line is not specified or does not exist, the lines are moved to the end of the
workspace.

The workspace pointer remains pointing to the same line, even if that line moves.

EXAMPLES

Assume that the workspace contains the following text:

DO
RE
SO
LA

MI
FA
DO

Enter the following command:

» MOVE 3-5 8

Lines 3, 4, and 5 are inserted before line 8. The rearranged workspace is shown below.
Notice that "Tl" is still the current line, even though its line number has changed from 5 to 7.

DO
RE

MI
FA
SO
LA

3-44

Command Dictionary — 8002A Editor Version 3.X

Advances to next block of text

SYNTAX

NEXT [number of lines]

PARAMETERS

number of lines number of new lines to be brought into the workspace.

EXPLANATION

The NEXT command appends the workspace contents (if any) to the primary output file,
clears the workspace, and copies the specified number of lines from the primary input file
into the workspace.

If a number of lines is not specified, the workspace is filled to three-fourths of its capacity
with text from the primary input file.

After the new lines have been brought into the workspace, the first line in the workspace
becomes the current line and is displayed.

Any of the following messages may be displayed during normal execution of a NEXT
command:

END OF TEXT The workspace contents have been appended to the primary output

file.

WORKSPACE FULL Text from the primary input file has filled the workspace to full
capacity, if a number of lines was specified, or to three-fourths of its
capacity otherwise.

EOF

The primary input file has been read to its end.

EXAMPLES

The following two command lines are equivalent:

*NEXT 50

*PUTK B-E:GET 50:BEGIN

3-45

Advances to next block of text

Command Dictionary— 8002A Editor Version 3.X

Consider the following situation. (Note the position of the primary input file pointer

primary

input

file

ONE

TWO

THREE

FOUR

FIVE

SIX

workspace

ONE
AND A

primary (empty)

output

file

HALF

TWO

Enter the command:

« NEXT 3

The workspace contents are moved to the primary output file; then the next three lines from
the primary input file are brought into the workspace. The editor reports when the workspace
has been cleared, then displays the new current line when copying is finished.

** END OF TEXT
THREE

After execution of the command, the files and workspace look like this:

primary

input

file

ONE

TWO

THREE

FOUR

FIVE

SIX

workspace

THREE

FOUR

FIVE

primary

output

file

ONE
AND A
HALF
TWO

3-46

Command Dictionary— 8002A Editor Version 3.X

NUMBER

Controls display of line numbers

SYNTAX

NUMBER

ON
OFF

PARAMETERS

ON
OFF

causes line numbers to accompany the displayed text,
suppresses the display of line numbers.

EXPLANATION

The NUMBER command sets the value of the NUMBER flag.

The editor can display workspace text with or without line numbers. Normally (NUMBER flag
OFF) line numbers are not displayed. Turning the NUMBER flag ON causes each line
displayed to be accompanied by the number indicating that line's position in the workspace.
Turning the NUMBER flag OFF suppresses the display of line numbers.

Entering the NUMBER command without a parameter reverses the value of the NUMBER
flag.

EXAMPLES

Assume that the following text is in the workspace:

WHEN

DOUBT,

► CLEAR

THE
ACCUMULATOR.

Enter the following command:
•TYPE 3

3-47

NUMBER

Controls display of line numbers

Command Dictionary— 8002A Editor Version 3.X

The editor displays three lines, beginning with the current line.

CLEAR

THE

ACCUMULATOR.

Now turn on line numbering and display the same three lines:

"NUMBER ON
*TTFE~1

Line numbers are displayed.

CLEAR

THE

ACCUMULATOR

3-48

Command Dictionary — 8002A Editor Version 3.X

PERFORM

Executes commands from command UU

SYNTAX

PERFORM {command file[/disc]}

PARAMETERS

command file name of a file containing editor commands.

disc number of the disc drive unit on which the specified file is stored. If no

drive is specified, the system disc is assumed.

EXPLANATION

The PERFORM command causes the editor to begin executing commands from the specified
file. When the end of the command file is reached or an error is detected, the editor prompts
for a command from the system terminal. The editing session will terminate if a FILE or QUIT
command is executed from the command file.

All the usual editor responses (prompt character, current-line display, text display,
informative messages, error messages) are displayed on the system terminal. In addition, if
the ECHO flag is ON, each command line is displayed before it is executed.

Commands following PERFORM on the same command line will not be executed.

A command file may contain any editor command except PERFORM.

The initial command file (specified by the third parameter of the EDIT command) is treated as
if it has been started by a PERFORM command.

EXAMPLES

Assume that the BRIEF flag is OFF, the ECHO flag is ON, and the following text is in the
workspace:

I DO NOT UNDERSTAND COMMAND FILES.
I DO NOT LIKE COMMAND FILES.
m- I DO NOT USE COMMAND FILES.

Disc file PEPTALK contains the following text:

BEGIN. :*<FS/DO NOT //>

END.rlNSERT I'M OK; COMMAND FILES ARE OK.

(a)

3-49

PERFORM

Executes commands from command file

Command Dictionary— 8002A Editor Version 3.X

Execute the command file:

"PERFORM PEPTALK

The first line of the command file moves the workspace pointer to the first line, then deletes
all occurrences of the string "DO NOT ". The second command line inserts a line at the end
of the workspace. The editor responds as follows as it executes the command file:

*BEGIN. :*<FS/D0 NOT //>

first command line echoed

I UNDERSTAND COMMAND
I LIKE COMMAND FILES
I USE COMMAND FILES.

** NOT FOUND
*END. :INSERT I'M OK;

FILES. revised current line

new current line

no more occurrences of the string
COMMAND FILES ARE OK.

second command line echoed

ready for a command from the keyboard

The workspace now looks like this:

I UNDERSTAND COMMAND FILES.

I LIKE COMMAND FILES.

I USE COMMAND FILES.

I'M OK; COMMAND FILES ARE OK.

3-50

(a)

Command Dictionary— 8002A Editor Version 3.X

PUT

Copies workspace text to file or device

SYNTAX

PUT

number
range

x of lines!
of lines J

[output file[/disc]]

PARAMETERS

number of lines number of lines to be written, beginning with the current line.

range of lines range of lines to be listed, for example 2-6. B, C, and E may be used

to represent the first line, current line, and end of workspace,
respectively.

output file name of the file or device to which text is written. To specify the primary

output file, omit this parameter.

disc number of the disc drive unit on which the specified file is stored. If no

drive is specified, the system disc is assumed.

EXPLANATION

The PUT command writes the specified lines of workspace text onto the specified file or
device. The workspace contents and pointer are not affected.

If neither a number of lines nor a range of lines is given, only the current line is copied.

If no output file or device is specified, text is appended to the primary output file.

If an alternate output file is specified, its contents are replaced by the copied text. If the
specified file did not previously exist, it is created. You may not specify the primary output file
by name, and you may not specify the primary input file at all.

EXAMPLES

•PUT
appends a copy of the current line to the primary output file.

•PUT 1-20 FILEA/1
replaces the contents of FILEA on disc 1 with a copy of the first 20 lines in the workspace.

•PUT 30 LPT1
lists 30 lines on the line printer, beginning with the current line.

3-51

PUTK

Moves workspace text to file or device Command Dictionary— 8002A Editor Version 3.X

SYNTAX

plumber of lines"]

PUTK

[range of

lines

[output file[/disc]]

PARAMETERS

number of lines number of lines to be written, beginning with the current line.

range of lines range of lines to be moved, for example 2-6. B, C, and E may be used

to represent the first line, current line, and end of workspace,
respectively.

output file name of the file or device to which text is written. To specify the primary

output file, omit this parameter.

disc number of the disc drive unit on which the specified file is stored. If no

drive is specified, the system disc is assumed.

EXPLANATION

PUTK combines the functions of the commands PUT and KILL.

The PUTK command writes the specified lines of workspace text onto the specified file or
device, then deletes those lines from the workspace.

The workspace pointer does not move unless the current line is deleted, in which case the
first line after the deleted text becomes the current line.

If neither a number of lines nor a range of lines is given, only the current line is copied and
deleted.

If no output file or device is specified, text is appended to the primary output file.

EXAMPLES

*PUTK
appends the current line to the primary output file and deletes the line from the workspace.
The next line becomes the current line.

*PUTK 1-20 FILEA/1
replaces the contents of FILEA on disc 1 with the first 20 lines in the workspace and deletes
those lines from the workspace. If the current line is among those deleted, the new first line
(formerly line 21) becomes the current line.

*PUTK 30 LPT1
lists 30 lines on the line printer, beginning with the current line, and deletes those lines from
the workspace. The first line after the deleted text becomes the current line.

3-52 (a)

Command Dictionary— 8002A Editor Version 3.X

QUIT

Aborts editing session

SYNTAX

QUii

EXPLANATION

The QUIT command aborts the editing session.

If the primary output file is a new file or a new version of the primary input file, the primary
output file is deleted.

If the primary output file existed before the editing session began:

• If no text has been written to it in the current editing session (through commands such
as COPY, FNEXT, NEXT, PUT and PUTK), it retains its original contents.

• Otherwise it contains only the text written to it during this editing session.
All changes made to alternate output files during this session are retained.

The primary input file remains unchanged, and its backup file (if any) is not deleted.

3-53

REPLACE

Replaces current line

Command Dictionary— 8002A Editor Version 3.X

SYNTAX

REPLACE {text}

PARAMETERS

text

any line of text.

EXPLANATION

The REPLACE command replaces the whole current line with the new text line specified. The
workspace pointer does not move.

If the command line, including the text, exceeds 127 characters, the editor displays the
message ** COMMAND INPUT ABORTED and the command line is lost.

One or more spaces must separate the command from the text. The text may not begin with
a space.

The new line is displayed. To suppress the display, enter a period between the command and
the space preceding the text.

EXAMPLES

Assume that the current line is:

»► A LINE

Enter the following command:

•REPLACE A NEW LINE

The new line is displayed:

A NEW LINE

Command Dictionary— 8002A Editor Version 3.X

SAVE

Copies workspace text to save area

__ _£ H___-1

numuer ut lines

SAVE [.range of lines J

SYNTAX

PARAMETERS

number of lines
range of iines

number of lines to be saved, beginning with the current line.

range of lines to be displayed, for example 2-6. B, C, and E may be
used to represent the first line, current line, and end of workspace,
respectively.

EXPLANATION

The SAVE command replaces the current contents of the save area (if any) with the specified
lines of workspace text. The workspace contents and pointer are not affected.

If neither a number of lines nor a range of lines is specified, only the current line is saved.

The UNSAVE command retrieves saved text.

EXAMPLES

•SAVE

replaces the contents of the save area with a copy of the current line.

•SAVE 30-40
replaces the contents of the save area with a copy of workspace lines 30 through 40.

NOTE

The workspace and the save area share the same section of memory in the editor. Storing a
large section of text in the save aea may noticeably reduce the capacity of the workspace.

If you receive the message WORKSPACE FULL in response to a SA VE command, there is
not enough space in the save area for the text you are storing. You can store the text on a
disc file with a PUT command and retrieve it with a GET command instead of using SA VE
and UNSAVE.

3-55

STATUS

Displays editor status

Command Dictionary— 8002A Editor Version 3.X

SYNTAX

STATUS

EXPLANATION

The STATUS command displays information about the current status of the editor.

EXAMPLES

Enter the command:

•STATUS

The editor displays the following information:

STATUS

PI = FILE1

LINE 101
P0 = FILE1

LINE 50

LAST AI r FILE2
LAST AO =
COMMAND FILE =
TAB CHARACTER = &
TAB STOPS = 8
BRIEF false
CRT true

DEBUG false
ECHO true

ERROR true
NUMBER false
UPARROW false
XSEARCH false
XTABS false
CURRENT LINE:
15 ( 60)

16 24 32 40 48 56 64

This information can be interpreted as follows:

The primary input file (PI) is the current version of disc file FILE1. One hundred lines have
been read from FILE1: the primary input file pointer is at line 101.

The primary output file (PO) is the new version of FILE1. Fifty lines have been written to the
primary output file.

The last alternate input file (AI) read from (by a GET or COPY command) is FILE2.

3-bb

STATUS

Command Dictionary— 8002A Editor Version 3.X Displays editor status

No alternate output files have been written on.

There was no initial command file specified in the EDIT command line.

The tab character is &. The default tab stops are in effect.

All editor flags are at their default values. (TRUE is synonymous with ON; FALSE is
synonymous with OFF.)

Workspace line 15 is the current iine. There are 60 iines in the workspace.

@ 3-57

SUBSTITUTE

Replaces string Command Dictionary— 8002A Editor Version 3.X

SYNTAX
SUBSTITUTE {/old string/new string/}

PARAMETERS

string delimiter: any character except a space. The delimiter character must not
occur in either string. All three delimiters must be the same character. If the
delimiter character is a letter or period, a space must separate the command from
the first delimiter. The final delimiter may be omitted if it is the last character in
the command line.

old string the string of characters you want to replace.

new string the string of characters that replaces the old string.

EXPLANATION

The SUBSTITUTE command searches the current line for the old string. If the old string is
found, the new string replaces it. If the old string does not occur in the current line, the
message ** NOT FOUND is displayed.

The workspace pointer does not move.

The strings may be of different lengths. If the new string is empty, the old string is deleted.

After the substitution, the modified line is displayed. To suppress the display, enter a period
between the command and the first delimiter.

If the modified line exceeds 127 characters, the line is truncated to 127 characters and the
editor displays the message ** TRUNCATED along with the truncated line.

If a SUBSTITUTE command inside repeat brackets ("<" and ">") fails to find a match,
command execution resumes with the next command outside the brackets.

If you are using tab stops, remember that while each tab character in the text is displayed as
one or more spaces, it is stored as a single character. To include a standard tab character in
the old string or the new string, press the TAB key at the appropriate place in the command
line.

See the XSEARCH command for an explanation of special search characters.

3-58 REV A JUN 1980

SUBSTITUTE

Command Dictionary— 8002A Editor Version 3.X Replaces string

EXAMPLES

Ao<m i mey thiot tho \A»nri/cnapfl mental r*o tho f r\iir\\*/inn tqx/t-

r\OOU I I I V> L> IUL kl IV V¥WI IW^UVW Wl HUMiO kJ IV IVSIIWVVIIIH LOAl,

► THIS IS A LINE.

HERE IS ANOTHER.

Enter the following command:

* SUBSTITUTE/A/A CHANGED/

The modified line is displayed:

THIS IS A CHANGED LINE.

Enter the following command:

• SUBSTITUTE/ HERE/THIS/

The editor responds:

** NOT FOUND

To replace a string on a different line, you must use the FSUBSTITUTE command, described
earlier in this dictionary.

<s> 3-59

SUSPEND

Exits temporarily to TEKDOS

Command Dictionary— 8002A Editor Version 3.X

SYNTAX

SUSPEND

EXPLANATION

The SUSPEND command suspends the editor. Control passes to TEKDOS and the prompt > is
displayed. When you enter the TEKDOS command CONT *, control returns to the editor. The
editor prompts for another command or resumes execution of the command file in progress.

If you enter the TEKDOS command ABORT * while the editor is suspended, the editing
session is aborted as with a QUIT command.

**.fin

TAB

Command Dictionary— 8002A Editor Version 3.X

Defines editor tab character

YNTAX

TAB (character!

PARAMETERS

character

the character to be used as the editor tab character. You may not specify
the colon (:), less-than (<), greater-than (>), space, or carriage return.

EXPLANATION

The standard tab character is CTRL-! (ASCII code 09), which may be entered in one of two
ways:

• Press the TAB key.

• Press the I key while holding down the CTRL (control) key.

The TAB command defines the editor tab character, which you may use as an alternative to
the standard tab character. When you invoke the editor, the editor tab character is undefined.
Each TAB command removes the significance of any previous editor tab character.

The editor tab character is like the standard tab character in most respects:

• When you type either tab character, that character is inserted into the line being
entered and the cursor advances to the next tab stop.

• When text containing tab characters is displayed, spaces are inserted to align the text to
the current tab stops.

• When text containing tab characters is saved on a file:

If the XTABS flag is ON, each tab character copied is expanded to the appropriate
number of spaces.

If the XTABS flag is OFF, tab characters are copied unchanged.

Unlike the standard tab character, the editor tab character has no meaning outside the
current editing session. TEKDOS routines such as ASM and MDL recognize only the
standard tab character, and the editor does not remember the editor tab character from a
previous editing session.

Since the standard tab character is not printable, you may find it easier to keep track of tabs
in your text if you use a printable character as the editor tab character.

3-61

TAB

Defines editor tab character Command Dictionary— 8002A Editor Version 3.X

EXAMPLES

Create three lines of assembly language source code using the percent sign (%) as the tab
character:

*TAB %

*TFFUT

INF0T7

DEMO%LXI5&H,500$; SET TABLE POINTER

*MVI*B,5*; SET PASS COUNTER

%XRA*AE; CLEAR ACCUMULATOR

Display the text you have created:

*TYPE B-E

DEFTO LTI H,500

MVI B,5
XRA A

SET TABLE POINTER
SET PASS COUNTER
CLEAR ACCUMULATOR

In order to save the text with spaces instead of percent signs, you must turn the XTABS flag
ON:

*XTABS ON

» FTLT

"S^TND OF TEXT
*DOS* EOJ

The following example shows how redefining the editor tab character affects your text. In
this example, "t" denotes the standard tab character.

Assume that the workspace is empty and the editor tab character is undefined. Enter the
following text:

» INPUT

INPUT:

THIStlStAtLINEtOFtTEXT

HERE%IS%ANOTHER

A=BIG=WORD=OVERRIDES=TABS

Display the text you have entered:

•TYPE B-E

TTrrs — rs a line of text

HEREJIS^ANOTriER
ArBIG=WORD=OVERRIDES=TABS

3-62 @

! AtS

Command Dictionary— 8002A Editor Version 3.X Defines editor tab character

Set the editor tab character to % and display the text again:

*TAB %
» TTPE~B-E

tUTc — tc" ft T tmc- r\C TIT YT

HERE IS ONE MORE

A=BIG=WORD=OVERRIDES=TABS

Each % in the text is treated as a tab character.

Change the editor tab character to = and display the text again:

*TAB =

» TYFE~B-E

THIS IS A LINE OF TEXT

HERE%IS%ONE%MORE

A BIG WORD OVERRIDES TABS

The % is no longer a tab character.

@ 3-63

TABS

Redefines tab stops

Command Dictionary— 8002A Editor Version 3 X

SYNTAX

TABS {column! [column]

column

PARAMETERS

column number of the tab stop. Up to eight tab stops may be specified.

EXPLANATION

The TABS command eliminates all existing tab stops and defines up to eight new tab stops.

A column number may not be less than 1 or greater than 127.

Column numbers must be specified in ascending order.

When the editor is invoked, there are eight default tab stops set at 8, 16, 24, 32, 40, 48, 56,
and 64 spaces from the left margin.

Tab stops are not retained from one editing session to the next.

Text is aligned according to the current tab stops, even if the text was created with different
tab settings. If the original tab characters have been replaced by spaces, no realignment is
possible. See the XTABS command.

EXAMPLES

Set the editor tab character to % and enter the following text:

*TAB %

*twfut

INPUT:

THIS%IS%A LINESOF TEXT

THIS%%IS%0NE% M0RE

*HEREXIS%AN0THt:k*ONE

Display the text using the default tab stops:

A LINE OF TEXT

*UP.3:TYPE 3

TTTT5 TS

THIS IS

HERE IS

ONE MORE
ANOTHER ONE

3-64

TABS

Command Dictionary-8002A Editor Version 3 X Redefines tab stops

If you specify new tab stops,, all the old stops are lost. Enter the following command line:

* TABS 10:TYPE 3

With only one tab stop, the text looks like this:

THIS IS A LINE OF TEXT

THIS IS ONE MORE

HERE IS ANOTHER ONE

Note that any tab character beyond the last tab stop is displayed as a space, but remains
unchanged in the text. Display the same text with some new tab stops:

*TABS 7 14 23 32 :TYPE 3

THIS

A LINE

OF TEXT

THIS

ONE

HERE

ANOTHER

ONE

@ 3-65

TYPE

Displays text on terminal

Command Dictionary — 8002A Editor Version 3.X

[number of lines"
TYPE [range of lines

SYNTAX

PARAMETERS

number of lines number of lines to be displayed, beginning with the current line.

range of lines range of lines to be saved, for example 2-6. B, C, and E may be used to

represent the first line, current line, and end of workspace, respectively.

EXPLANATION

The TYPE command displays the specified lines of workspace text on the system terminal.

The workspace contents and pointer are not affected.

If neither a number of lines nor a range of lines is specified, only the current line is displayed.

EXAMPLES

"TYPE
displays the current line.

*TYPE 10
displays 10 lines beginning with the current line.

•TYPE 5-15
displays workspace lines 5 through 15.

3-66

UNSAVE

Command Dictionary— 8002A Editor Version 3,X

Copies text from save area to workspace

SYNTAX

UNSAVE

EXPLANATION

The UNSAVE command copies the contents of the save area into the workspace, inserting
them before the current line.

The save area is not affected.

The current line remains the same.

EXAMPLES

Assume that the following text is in the workspace:

WELL,

► HE RAN

AND

HE GOT
VERY TIRED.

Enter the following command:

« SAVE 2

Two lines of text, beginning with the current line, are copied into the save area. The
workspace remains the same. The save area contains the following text:

HE RAN
AND

Enter the following command line:

* UNSAVE: UNSAVE

Each UNSAVE command inserts a copy of the two saved lines in front of the current line. The
workspace now looks like this:

WELL,
HE RAN
AND

HE RAN
AND

T U IT DAM
» lit-* nnn

AND

HE GOT
VERY TIRED.

<S>

3-67

Moves pointer up

Command Dictionary— 8002A Editor Version 3.X

SYNTAX

UP [number of lines]

PARAMETERS

number of lines number of lines the pointer moves up.

EXPLANATION

The UP command moves the workspace pointer the specified number of lines toward the
beginning of the workspace.

The new current line is displayed. To suppress the display, enter a period immediately after
the command, before any space or number.

If you do not specify a number of lines, the pointer moves up one line.

If moving the pointer the specified number of lines would cause the pointer to go past the
beginning of the workspace, the pointer stops at line 1 .

EXAMPLES

Assume that the workspace contains the following text:

A LINE
B LINE
C D LINE

► E LINE IS THE NEXT TO

LAST LINE

Enter the following command:

» UP 2

The pointer moves up two lines and displays the new current line.

B LINE

The workspace now looks like this:

A LINE

^- B LINE

C D LINE

E LINE IS THE NEXT TO

LAST LINE

3-68

Command Dictionary — 8002A Editor Version 3.X

UPARROW

Controls control-character handling

SYNTAX

UPARROW

[-J

PARAMETERS

assigns the uparrow character to special use in representing control
characters.

OFF

removes the special significance of the uparrow character.

EXPLANATION

The UPARROW command sets the value of the UPARROW flag. Turn the UPARROW flag ON
when you want to display text containing control characters.

Normally (UPARROW flag OFF) the uparrow character (A or ! ) has no special significance to
the editor. Turning the UPARROW flag ON allows any control character to be entered or
displayed as an uparrow followed by a printable character. For example, the control
characters NULL, BACKSPACE, and ESCAPE are represented as A@, AH, and A [. The ASCII
code of the printable character (64 to 95) is equal to 64 plus the ASCII code of the control
character (0 to 31).

All control characters except the carriage return and the current tab character can be
represented using the uparrow.

When the UPARROW flag is OFF, the editor displays any control character as itself, and does
not treat the uparrow character specially. How a control character is displayed depends on
the display device and the control character.

Entering the UPARROW command without a parameter reverses the value of the UPARROW
flag.

You may want to think of the uparrow as representing the CTRL (control) key. For example,
AA represents the control character CTRL-A, AB represents CTRL-B, and so on. The 8002A
//Processor Lab System Users Manual contains an ASCII-Binary-Decimal Conversion Table.
Control characters occupy columns 1 and 2 of the table. Columns 5 and 6 contain the
printable characters that may be used to represent the control characters.

3-69

UPARROW

Controls control-character handling

Command Dictionary — 8002A Editor Version 3.X

EXAMPLES

The following table shows how the editor stores the text you enter.

What the editor stores

UPARROW

flag OFF

UPARROW

flag ON

What you type

characters

ASCII codes

characters

ASCII codes

94,91

(ESC)

94,71

(BELL)

94,103

(CTRL-G)

(BELL)

The following table shows how the editor displays the text it has stored.

What the
characters

editor
ASCII

stores
codes

What the edii
UPARROW flag OFF

tor displays
UPARROW

flag

(ESC)
(BELL)

94,71

depends on
depends on

terminal
terminal

A[
AG
AG

Enter the following command:

» INSERT THIS BELL GOES "G"G

With the UPARROW flag OFF, all characters in the inserted text are stored just as they are.
The ASCII codes for the last four characters stored are 94, 71, 94, 71. Now turn the
UPARROW flag ON and insert another line of text.

*UPARR0W ON

» IN5ERT THTT BELL GOES ~G~G~G

This time, each AG is stored as a single control character (BELL, ASCII code 7). Note that

ASCII(BELL) = ASCII (CTRL-G) = ASCII(G) - 64

Display both iines of text.

*UP.2:TYPE 2

3-70

UPARROW

Command Dictionary— 8002A Editor Version 3.X Controls control-character handling

With the UPARROW flag ON., each BELL character is displayed as AG.

THIS BELL GOES ~G~G
THAT BELL GOES ~G~G~G

Now turn the UPARROW flag OFF again and display the two lines.

* UPARROW OFF:TYPE 2

This time the exact contents of the lines are sent to the system terminal:

THIS BELL GOES ~G~G

THAT BELL GOES (ding) (ding) (ding)

Each BELL character rings the bell on the system terminal.

3-71

XSEARCH

Controls wildcard searches

Command Dictionary— 8002A Editor Version 3.X

roN-i

XSEARCH LOFFJ

SYNTAX

PARAMETERS

ON
OFF

enables the wildcard search feature,
disables the wildcard search feature.

EXPLANATION

The XSEARCH command sets the value of the XSEARCH flag.

When the XSEARCH flag is ON, the characters "?" and ">" have special meanings in search
and replacement strings:

• In a search string, "?" matches any single character. In a replacement string, "?" stands
for whatever character it matched in the search string.

• The character ">" signifies a carriage return, which is the last character in any line of
text. The carriage return separates one line of text from the next.

Additionally, when the XSEARCH flag is ON, a search or replacement string may begin on
one line of text and end on another.

When the XSEARCH flag is OFF, "?" and ">" have no special meanings, and strings are not
considered to cross or include line boundaries.

Entering the XSEARCH command without a parameter reverses the value of the XSEARCH
flag.

The XSEARCH flag is initially OFF.

EXAMPLES

All of the following examples assume that the XSEARCH flag is ON.

XSEARCH

Command Dictionary— 8002A Editor Version 3.X Controls wildcard searches

SEARCH SIRING tXAMHLbS

*FIND/A?C/
finds any three-character string beginning with "A" and ending with "C".

*FIND/END. >/
finds a line ending with "END.".

*FIND/>THE/

finds a line beginning with "THE". The line preceding that line becomes the current line,
because the carriage return (>) belongs to the line preceding 'THE".

*FIND/>ALONE>/

finds a line containing "ALONE" and nothing else. The line preceding "ALONE" becomes the
current line.

REPLACEMENT STRING EXAMPLES

*SUB/A?/XYZ/

deletes the "A" and whatever character follows it and substitutes the string "XYZ".

*SUB/A?C/X?Z/

substitutes "X" for "A" and "Z" for "C" but leaves the character between them unchanged.

*SUB/ABC?/?ABC/
moves the character matched by "?" from behind the string "ABC" to in front of it.

*SUB/A?C/A????C/
inserts three additional copies of the character between "A" and "C".

*SUB/A??D/X?????Y/
acting on the string "ABCD" results in "XBCBCBY".

*SUB/AC/A?C/
inserts a question mark between "A" and "C".

*SUB/NEW LINE/NEVOLINE/
inserts a carriage return between the words "NEW" and "LINE", making one line into two.

*FSUB/NEW>LINE/NEW LINE/
combines two lines into a single line.

*SUB/NEW>LINE/NEW LINE/

produces the response ** NOT FOUND because the SUBSTITUTE command stops searching
at the first carriage return.

*FSUB/>/>>/
inserts an empty line after the current line.

@ 3-73

XTABS

Controls tab character expansion

Command Dictionary— 8002A Editor Version 3.X

roN-i

XTABS LOFFJ

SYNTAX

PARAMETERS

ON
OFF

specifies that tab characters are to be expanded to spaces on output.

specifies that text is to be output with tab characters.

EXPLANATION

The XTABS command sets the value of the XTABS flag.

When you use tab stops in creating text, each tab character you enter is stored in the text.
When one of the following commands copies text from the workspace to a file or device, the
editor checks the XTABS flag.

FILE FNEXT NEXT PUT PUTK

If the XTABS flag is ON, each tab character copied is replaced with the number of spaces
appropriate to the current set of tab stops.

If the flag is OFF, tab characters are copied unchanged.

Entering the XTABS command without a parameter reverses the value of the XTABS flag.

The XTABS flag is initially OFF.

A file containing standard tab characters is correctly processed by such TEKDOS routines as
ASM and MDL, but may produce unexpected results if used as a command file or data file.

Since each tab character generally replaces several spaces, a file created with XTABS OFF
usually occupies less disc space than the same file created with XTABS ON.

A file containing non-standard tab characters (defined with the TAB command) is usually
useless. Turn the XTABS flag ON before saving text aligned with non-standard tab
characters.

3-74

Command Dictionary— 8002A Editor Version 3.X

XTABS

Controls tab character expansion

EXAMPLES

In these examples "t" denotes the standard tab character.

Assume that the tab stops and XTABS flag are at their default values. The workspace
contains four lines of assembly language:

tXRAtAt; CLEAR ACCUMULATOR
LOOPtADDtMt; ADD BYTE FROM TABLE
tINXtHt; POINT TO NEXT BYTE
tDCRtBt; DECREMENT PASS COUNTER

The following command writes an exact copy of the workspace contents into FILE1

* PUT B-E FILE1

Now enter the following command line:

*XTABS ON: PUT B-E FILE2

The PUT command copies the workspace contents to FILE2. Because the XTABS flag is ON
now, each tab character is replaced by spaces up to the next tab stop.

Counting carriage returns, the workspace and FILE1 each contain 120 characters. FILE2
contains 180 characters and looks like this:

LOOP

XRA

ADD

INX

DCR

; CLEAR ACCUMULATOR
; ADD BYTE FROM TABLE
; POINT TO NEXT BYTE
; DECREMENT PASS COUNTER

3-75

8002A Editor Version 3.X

Section 4
TECHNICAL NOTES

NOTE 1.

COMPARISON OF TEKDOS EDITOR VERSION 3.X WITH

PREVIOUS VERSIONS

Introduction

This technical note provides a list of the differences between the new version of the TEKDOS
Editor and the previous versions. The new editor, version 3.X, offers extensions and
improvements over the previous versions. Most of the commands in the previous versions
are unchanged to minimize transition problems for those familiar with the previous versions.
Many new commands have been added and some of the previous commands have been
extended. Two commands have been given new names: N has been changed to LN, and ? has
been changed to STATUS. The remainder of this technical note includes a general list and a
command-by-command list of new and changed features.

New Features

• The new version runs faster than the prevous versions.

• All of program memory, rather than only 1 6K, is used for the editor and the workspace.

• You can use the PERFORM command to execute editor command files that initialize the
editing session, define macros, or perform frequently used command sequences.

• You may specify an initial command file in the EDIT command line. The specified
command file is automatically executed at the beginning of the edit session.

• It is simpler, with the new commands NEXT and FNEXT, to edit files that exceed the size
of the workspace.

• It is simpler, with the new commands FNEXT and FSUBSTITUTE, to search for and
replace strings.

• It is simpler, with the new commands MOVE, SAVE, and UNSAVE, to move blocks of
text.

O 4-1

Technical Notes— 8002A Editor Version 3.X

When an existing file is edited, the old version is saved as a backup.

An extended search feature, controlled by the XSEARCH command, allows you to use
wildcard characters in search strings, and to edit multiline strings.

Tab characters may be stored unexpanded in files, to save disc space. The tabs may also
be expanded to spaces, as in previous versions of the editor. The XTABS command
controls the expansion of tab characters.
Each error message indicates the command or parameter that caused the error.

When a command within repeat brackets (< >) fails, only the command sequence within

those brackets stops; command execution continues with the next command outside the

brackets.

Control characters may be entered and displayed more easily when the UPARROW

feature is on.

Lines are displayed with line numbers when the NUMBER feature is on.

Specific Command Changes

AGAIN Unchanged.

BEGIN Unchanged.

BRIEF Accepts boolean parameters ON and OFF. If no parameter is given, the

BRIEF command operates the same as in previous versions.

COMMENT New command. Precedes a comment in a command file.

COPY The primary input and output files are now used as default files if no

alternate files or devices are specified.

CRT New command. Controls the function of the RUBOUT key.

DEBUG New command. Controls display of the workspace map.

DOWN Unchanged.

ECHO New command. Controls command display in an executing command

file.

EDIT An initial command file may be specified as an optional third parameter.

END Unchanged.

ERROR New command. Controls display of the error pointer.

4-2

(ft

Technicai Notes— 8002A Editor Version 3.X

FiLE

FIND

FNEXT

FSUBSTITUTE

GET

INPUT

INSERT

KILL

LIST

MACRO

MOVE

NUMBER

PERFORM

PUT

PUTK

QUIT

REPLACE

SAVE

Creates a backup of the primary input file, if no primary output iile was
specified when the editor was invoked, you may not use the FILE
command to exit from the editor, if you attempt to exit, the message "NO
OUTPUT FILE SPECIFIED" is displayed. You must then exit with the
QUIT command.

Enhanced by the extended search feature. Accepts wildcard characters
">" and "?" when the XSEARCH feature is on.

New command. Searches the workspace and primary input file for a
string.

New command. Finds and replaces a string.

Unchanged.

Command name is changed from N in previous version.

Unchanged.

New command. Moves lines of text within the workspace.

Command name is changed to LN in new version. N is now the short
form of NEXT .

New command. Brings the next section of text into the workspace.

New command. Controls display of line numbers.

New command. Executes commands from a command file.

Unchanged.

New command. Saves lines of text in the save area.

(a)

4-3

Technical Notes— 8002A Editor Version 3.X

STATUS Command name is changed from ? in previous version.

SUBSTITUTE Enhanced by the extended search feature. Accepts wildcard characters

">" and "?" when the XSEARCH feature is on.
SUSPEND Unchanged.

TAB Tab characters are stored in the text unexpanded to save space. If the

XTABS feature is on, each tab character is converted to the appropriate
number of spaces when the text is stored in a file.

TABS All previous tab stops are eliminated when new stops are defined.

TYPE Unchanged.

UNSAVE New command. Retrieves the text in the save area.

UP Unchanged.

UPARROW New command. Controls the representation of control characters.

XSEARCH New command. Controls the wildcard search feature.

XTABS New command. Controls expansion of tab characters when the contents

of the workspace is output to a file or external device.

? Command name is changed to STATUS in the new version.

4-4

(a)

8002A Editor Version 3.X

Section 5
ERROR MESSAGES

ASSIGN PROBLEM (LIST command). The channel reserved for the line printer (LPT1) is
assigned to some other device or file. (The ASSIGN PROBLEM message may also occur as a
submessage under the DOS STAT = xx message.)

BOOLEAN? The parameter ON or OFF was entered improperly after one of the following
commands: BRIEF, CRT, DEBUG, ECHO, ERROR, NUMBER, UPARROW, XSEARCH, or
XTABS.

BREAK. The ESCAPE key was pressed to terminate an editor function.

COMMAND INPUT ABORTED. An attempt was made to enter a command line longer than
127 characters; the entire line is lost.

CANNOT NEST COMMAND FILES. The command file being executed contains a
PERFORM command.

CANNOT READ. A write-only file or device was specified for input.

CANNOT READ NEW FILE. A nonexistent file or wrong disc drive number was specified for
input.

CANNOT WRITE. A read-only file or device was specified for output.

DISK FULL. The disc specified to receive output is full and cannot accept any more text.

DOS STAT = xx. A TEKDOS service call error occurred; the Service Calls section in your
8002A System Users Manual explains the SRB status code (xx). This message is followed by
submessages that indicate more precisely where the error occurred.

EMPTY SEARCH STRING. The search string was missing, contained no characters
between the delimiters, or was not terminated by a second delimiter identical to the first.

END OF FILE. The specified range of lines lies completely past the end of the file. This
message may also be displayed when no error has occurred to inform you that the editor has
read to the end of a file.

O 5-1

Error Messages — 8002A Editor Version 3.X

END OF TEXT. The specified range of lines lies completely outside the actual range of lines
in the workspace. This message may also be displayed when no error has occurred to inform
you that an editor function has reached the end of the workspace.

ERROR (command line). Commands were not separated by colons or too many parameters
were entered.

ERROR (MACRO command). The macro being executed contains a MACRO definition.

ERROR (REPLACE command). No text follows the REPLACE command.

ERROR (TABS command). A tab stop was specified out of ascending order, beyond the
maximum line length (127), or with a number syntax error. The current tab settings are not
altered.

FILE NAME TOO LONG. The specified file name contains more than eight characters.

ILLEGAL MACRO NUMBER. A macro number outside the range 1 to 127 was specified or
a syntax error was made.

ILLEGAL TAB CHARACTER. An attempt was made to specify a colon (:), left repeat bracket
(<), right repeat bracket (>), space, or carriage return as the editor tab character.

MISSING DELIMITER. A delimiter in an FSUBSTITUTE or SUBSTITUTE command was
missing.

NEST. Repeat brackets (< >) were not entered in matching pairs.

NEW FILE. Informs you, upon invoking the editor, that you are beginning a new file; there is
no primary input file to read data from. Also appears when you have created a new file with
the COPY, PUT, or PUTK commands.

NO PI. No primary input file exists and no alternate input file was specified.

NO PO. No primary output file exists and no alternate output file was specified.

NO SAVED TEXT. An attempt was made to retrieve text from the save area but no text had
been saved previously.

NOT FOUND. The string being searched for was not found within or beyond the current
line. (The SUBSTITUTE command searches only the current line.)

NUMBER NOT ALLOWED. A numeric parameter was entered for a command that does not
take a numeric parameter.

5-2

Error Messages— 8002A Editor Version 3.X

kinMDCD \\r\-r cnnnw/cn rv <^ A nnmhpr wa<; fnund that should have started a
repeated command sequence, but was not followed by the left repeat bracket (<).

NUMBER? The line number parameter contained a syntax error.

PROCEDURE ERROR. A primary file was illegally specified as an alternate file.

RANGE? The range-of-lines parameter contained a syntax error.

SUPERSEDING EXISTING FILE. Warns that you have specified an existing file as the
primary output file. The previous contents of the file will be lost if you do not terminate the
editor with the QUIT command before copying any text to the primary output file.

TRUNCATED. An attempt was made to enter or create a text line longer than 127
characters. In an INPUT command, the line is lost and the message **TRUNCATED replaces
the lost text. In an FSUBSTITUTE or SUBSTITUTE command, the line is truncated to 127
characters.

UNKNOWN COMMAND. A nonexistent or misspelled command was entered.

WORKSPACE FULL. There is an insufficient amount of free area left in the workspace
buffer to execute the latest editor command. To gain more free area, KILL or PUTK some
workspace lines, delete some macros, or SAVE a smaller block of text. This message may
also be displayed after the NEXT or FNEXT commands to inform you that the workspace has
been filled to three-fourths of its capacity.

5-3

8002A Editor Version 3.X

Section 6
GLOSSARY

Alternate Input File (Al). A file that provides text to be edited. It may be any text file other
than the primary input file or the primary output file.

Alternate Output File (AO). A file that receives edited text. It may be any text file other than
the primary input file or the primary output file.

Command File. A disc file containing editor command lines as text. When a command file is
invoked by the PERFORM command, the command lines it contains are executed.

Command Line. A line of one or more editor commands. Multiple commands must be
separated by colons (:). The line may not contain more than 127 characters.

Current Line. A line of text in the workspace that serves as a point of reference for many
editor commands. The current line is pointed to by the workspace pointer, which may be
moved to any line in the workspace.

Editor. The TEKDOS system program that allows a user to create and modify text files
conveniently.

Editor Tab Character. See Tab Character .

Free Area. The area of the workspace buffer that is still available for use by the workspace,
macro area, and save area.

Initial Command File. An editor command file that is automatically executed at the
beginning of the edit session. The initial command file is an optional parameter of the EDIT
command. See Command File .

Macro. A specially defined command line that may be executed by a short command rather
than by typing in the whole line. Up to 1 27 macros may be stored in the macro area. Macros
are defined and executed by the MACRO command.

Macro Area. The area of the workspace buffer that holds the macros defined by the user for
the current editor session.

Primary Input File (PI). The default file from which text is read into the workspace to be

^-i/-J i + *-n~l Tkio -FiIq mow Krt onnAi^io/
cuucu. lino nib iiioy i_»c o^tijiiiCT

— - ■■ ■ — — — ■ wiicii ii ic cuiiui i» iitvuiveu

@ 6-1

Glossary— 8002A Editor Version 3.X

Primary Input File Pointer. A pointer maintained by the editor that points to the next line to
be copied from the primary input file. The primary input file pointer points initially to the first
line of the primary input file.

Primary Output File (PO). The default file into which edited text is stored from the
workspace. This file may be specified when the editor is invoked.

Program Memory. The 8002A ^Processor Lab memory used as a substitute for prototype
memory in the early stages of prototype development (emulation modes and 1). User
programs run in program memory, as does the editor and certain other system programs.

Repeat Brackets. The characters "<" and ">" used as brackets to enclose a command
sequence that is to be repeated.

Save Area. The area in the workspace buffer that stores the text copied from the workspace
by the most recent SAVE command.

Standard Tab Character. See Tab Character .

Tab Character. A character entered to instruct the editor to include spaces in a text line so
that the next character of text is in a tab column. The standard tab character (CTRL-I, ASCII
code 09) may be entered by pressing the TAB key, or by pressing the I key while holding
down the CTRL key. An optional editor tab character, defined by the TAB command, may be
used in place of the standard tab character, CTRL-I.

TEKDOS. The TEKtronix Disc Operating System; the operating system of the 8002A
/^Processor Lab.

Workspace. The area of the workspace buffer that holds the text currently being edited. Most
editor commands operate on the text currently in the workspace.

Workspace Buffer. The area of program memory used by the editor to store text. The editor
program occupies about 9K bytes of program memory. The rest of program memory constitutes the work-
space buffer. Each of four areas of the workspace buffer (workspace, free area, save area, and macro area)
may vary in size, but the size of the workspace buffer remains constant.

Workspace Map. A two-line display produced by the editor that gives the size and location of
each area of the workspace buffer. The command DEBUG ON causes the workspace map to
be displayed after execution of each editor command.

Workspace Pointer. A pointer maintained by the editor that points to the current line in the
workspace. See Current Line .

6-2 REVAJUN1980

8002A Editor Version 3.X

Section 7
INDEX

Al. See Alternate input file
AO. See Alternate output file
Aborting the editor, 3-53
AGAIN command, 3-6
Alternate input file, 3-1, 3-20
Alternate output file, 3-1, 3-20

Angle brackets, 3-3

Internet Archive Audio

Featured

Top

Images

Featured

Top

Software

Featured

Top

Books

Featured

Top

Video

Featured

Top

Mobile Apps

Browser Extensions

Archive-It Subscription

Save Page Now

Full text of "tektronix :: 800x :: 070-3441-00 8002A Edi Jan80"

See other formats